Spec0docs
CLI

CLI

@spec0/cli — the scriptable bridge between Spec0 and your terminal, CI runner, or AI agent.

@spec0/cli is the same surface humans, CI pipelines, and AI agents use. Every API + mock-management operation in the web app is reachable from a shell.

npm install -g @spec0/cli
spec0 --version

Requires Node.js 20+. Source: github.com/spec-0/CLI.

Three audiences, one command surface

  • Humans — colour, sensible defaults, interactive auth login.
  • CI — non-interactive via SPEC0_TOKEN + SPEC0_ORG_ID, stable exit codes.
  • AI agents — spec0 commands --output=json returns a full capability manifest. See agent playbook.

Sections

  • Commands — auto-generated reference for 29 commands.
  • Guides — end-to-end workflows.
  • Recipes — copy-paste task examples.

Issue a Service Account Token (SAT) for a team

Create a team-scoped, non-interactive token for use by CI pipelines, AI agents, or any caller that's not a human at a terminal. Pick scopes deliberately and copy the token once — it's only shown at creation.

Commands

Every spec0 command — auto-synced from @spec0/cli.

On this page

Three audiences, one command surfaceSections