@joincoby/cli

Installer wizard for the Coby Claude Code plugin.

Usage

npx @joincoby/cli init

The wizard will:

1. Verify the claude CLI is on your PATH
2. Prompt for your Coby API key
3. Write the key into ~/.claude/.credentials.json under pluginSecrets["coby-brain@coby"].api_key, preserving everything else (mode 0600)
4. Add the Coby-team/coby-plugins marketplace to Claude Code
5. Install the coby-brain plugin

After it finishes, open Claude Code and ask about a known Fimo user (e.g. "tell me about <user>"). The bundled customer-profile skill resolves the user via the brain and composes their PostHog activity, Pylon tickets, and Hyperline billing into a one-page profile.

What gets installed

The coby-brain plugin bundles two MCP servers:

• coby-brain — the Coby brain (HTTP, bearer-authed with your API key). Serves identity resolution + curated PostHog (product analytics) and Pylon (customer support) tool sets — 49 tools total.
• Hyperline — vendor MCP for billing, authenticates via browser OAuth on first use (expected behaviour, not a bug). PostHog and Pylon need no per-user OAuth — the brain serves them using Coby's workspace-level tokens.

Your Coby API key lands in ~/.claude/.credentials.json (or $CLAUDE_CONFIG_DIR/.credentials.json) under pluginSecrets["coby-brain@coby"].api_key — the same location Claude Code's native plugin-config flow uses for sensitive: true fields. The file is written 0600.

Recovering after a Claude Code self-upgrade

Sometimes Claude Code's self-upgrade silently wipes the pluginSecrets entry in ~/.claude/.credentials.json, leaving the Coby brain plugin unauthenticated. If Claude tells you it has no mcp__coby-brain__* tools, or that brain calls return an auth error, run:

npx @joincoby/cli doctor

This will:

1. Diagnose whether your credential is missing, present-but-rejected, or just temporarily unreachable.
2. If it's missing or rejected, prompt you to paste your Coby API key (request a fresh one from [email protected] if yours was revoked).
3. Save it to the right place for your platform (macOS Keychain on darwin, ~/.claude/.credentials.json on Linux / WSL / Windows).
4. Re-probe to confirm the new key works.
5. Tell you to run /reload-plugins in Claude Code to reconnect the MCP.

For scripts / agents, --diagnose-only skips the prompt:

npx @joincoby/cli doctor --diagnose-only   # exit 0=healthy, 1=needs repair, 2=brain down

Requirements

• Node.js ≥ 20
• Claude Code CLI installed and on your PATH

License

MIT