CLI

npx coback --help     # or: npm install -g coback

Authenticate once with coback login (stores the key in ~/.config/coback/config.json, mode 600) or set COBACK_API_KEY in the environment; the env var always wins, so CI and agents never touch disk. A self-hosted server is COBACK_API_URL.

Commands

coback login [--key K]              Validate and store an API key
coback logout                       Remove the stored key
coback whoami [--json]              Show workspace, key, and API host

coback brain list [--json]          List company-brain knowledge cards
coback brain search <query>         Semantic search over the brain
coback brain get <slug> [--json]    One card with full content
coback brain export [--json] [-o F] The whole brain as markdown (or JSON)

coback laws list [--jurisdiction J] [--since D] [--limit N] [--json]
coback matches list [--json]        Screening results with scores
coback matches feedback <id> --verdict relevant|irrelevant [--note N]

coback tasks list [--status S] [--json]
coback tasks create <title> [--priority P] [--due DATE]
coback tasks update <id> --status <status>

coback compliance products [--json]
coback compliance findings <productId> [--json]
coback upload <file...>             Upload documents into the corpus

coback mcp                          Print the claude mcp add command
coback skill install                Install the Claude skill

Conventions

  • Every list command takes --json for machine output; without it you get aligned columns.
  • Errors print the server's message to stderr and exit 1.
  • Write commands need a read-and-write key; a read-only key gets the server's 403 message.

Example

export COBACK_API_KEY=coback_brain_...
coback whoami
coback matches list --json | jq '.[0]'
coback tasks create "Review CSRD scope change" --priority high --due 2026-09-01