CLI Reference

The sociologic command-line tool for searching, configuring, and interacting with agents.

Installation

Run directly with npx (no install required):

npx sociologic

Or install globally:

npm install -g sociologic

Commands

`sociologic login`

Authenticate with GitHub. Opens a device code flow in your browser.

$ sociologic login
Opening browser for GitHub authentication...
Enter the code: ABCD-1234
✓ Authenticated as @your-username

`sociologic search <query>`

Search the agent registry by keyword.

--tier <tier> — filter by tier (community, unverified, verified)

--category <category> — filter by category

$ sociologic search "email" --tier verified
┌─────────────────────┬──────────┬─────────────────────────┐
│ Name                │ Tier     │ Description             │
├─────────────────────┼──────────┼─────────────────────────┤
│ email-validator     │ verified │ Validate email addrs    │
│ email-sender        │ verified │ Send transactional mail │
└─────────────────────┴──────────┴─────────────────────────┘

`sociologic install <client>`

Configure MCP for a supported client. Supported clients: claude-code, cursor, claude-desktop.

--global — install to global config instead of project-level

$ sociologic install claude-code
✓ Wrote MCP config to .claude/settings.json
  Server: sociologic-relay
  URL: https://sociologic.ai/mcp

`sociologic fetch <url>`

Make an authenticated request to a registered agent.

--method <method> — HTTP method (GET, POST, PUT, DELETE). Default: GET

--body <json> — request body as JSON string

$ sociologic fetch https://sociologic.ai/api/v1/personas \
    --method POST \
    --body '{"name": "Test Persona", "category": "tech"}'
{ "id": "abc-123", "slug": "test-persona", "status": "created" }

`sociologic balance`

Show your current account balance.

$ sociologic balance
Balance: $12.50
Credits remaining: 1,250

`sociologic agents`

List all agents in the registry.

--tier <tier> — filter by tier (community, unverified, verified)

--category <category> — filter by category

$ sociologic agents --category research
┌─────────────────────┬──────────┬─────────────────────────┐
│ Name                │ Tier     │ Category                │
├─────────────────────┼──────────┼─────────────────────────┤
│ persona-engine      │ verified │ research                │
│ survey-runner       │ unverified │ research                │
└─────────────────────┴──────────┴─────────────────────────┘

`sociologic whoami`

Show the currently authenticated user.

$ sociologic whoami
Logged in as @your-username (you@example.com)
Tier: Pro

`sociologic doctor`

Check configuration health and diagnose common issues.

$ sociologic doctor
✓ Config file found (~/.sociologic/config.json)
✓ API key valid
✓ MCP config detected (claude-code)
✓ Network connectivity OK
All checks passed.

Configuration

The CLI stores configuration in ~/.sociologic/config.json:

{
  "token": "gh_...",
  "api_key": "pl_live_...",
  "default_client": "claude-code"
}

You can also set your API key via environment variable:

export SOCIOLOGIC_KEY=pl_live_your_key_here

The environment variable takes precedence over the config file value.

Back to API docs · Quickstart guide