Spell Tome of the CLI

npm install -g @cstar.help/cli

cstar login --api-key sk_live_...
cstar status                           # team, env, rate limit
cstar logout

Credentials live in the OS keychain. Never on disk in plaintext.

# Forward production events to localhost — no ngrok
cstar listen --forward-to http://localhost:3000/webhooks

# Fire a synthetic event
cstar trigger ticket.created
cstar trigger boss.spawned

# Inspect available event types
cstar events
cstar events --category tickets

# Tail API logs in dev
cstar logs --tail
cstar logs --method POST --status 4xx --since 24h

# Manage keys
cstar keys list
cstar keys create --name "Prod" --type secret --environment live
cstar keys revoke key_abc123

# Run as MCP server for Claude Code, Cursor, Continue
cstar mcp-server --api-key sk_live_...

# Or wire into your AI tool's config:
{
  "mcpServers": {
    "cstar": {
      "command": "npx",
      "args": ["-y", "@cstar.help/cli", "mcp-server",
               "--api-key", "sk_live_..."]
    }
  }
}

# Populate test data — 5 categories, 12 articles, 3 customers, 5 tickets
cstar seed
cstar seed --clean                     # Wipe first
cstar seed --template helpdesk

# Scaffold a new integration
cstar create webhook-handler --framework next

• --json — structured output (stdout=data, stderr=status). Pipe to jq.
• --api-key <key> — override the stored key for one command.
• --base-url <url> — point at staging or a self-host.
• --no-color — for CI logs that mangle ANSI codes.
• cstar listen sends both X-Signature (canonical) and cstar-signature (legacy alias) so old receivers keep working.