Docs
CLI cheat sheet
Shell commands from the Go binary. The interactive TUI has a separate /… control surface.
Everyday
| Command | What it does |
|---|---|
captain doctor | Build identity, toolchain pins, capability probes, leg readiness; warns if CAPTAIN_DIRECTOR names a leg that is not ready |
captain doctor --rehearse | Clean-machine install/upgrade/rollback rehearsal |
captain director / director <leg> | Show or switch the director ladder (runnable legs only at startup) |
captain adi / adi refresh | ADI standing per leg (green/red/not measured) and green tuples no leg serves yet |
captain why | Last routing decision: candidates, exclusions, policy, charges |
captain quota | Observed/inferred quota per leg |
captain budget | Per-task budgets (attempts, cost, mode, stopping reason) |
captain stats | Aggregate ledger stats |
Evaluation
| Command | What it does |
|---|---|
captain eval verify <suite.json> | Non-vacuous fixture gate |
captain eval run <suite.json> --out <result.json> | Execute arms (uses provider credits) |
captain eval review <result.json> | Blinded pending verdicts |
captain eval report <result.json> | Acceptance / cost / latency table |
captain release report | Release package checklist |
Tasks, MCP & hosts
| Command | What it does |
|---|---|
captain task mcp | Stdio MCP: plan, submit, inspect, events, artifacts, cancel, resume |
captain task … | Same contract over HTTP /v1/task |
captain host pi / jido / cert | Host helpers and certification against a live brain |
captain cancel / lifecycle / resume | Cancellation and recovery |
captain handoff | Structured handoff brief |
When CAPTAIN_TASK_TOKEN is set, every /v1/task request needs Authorization: Bearer …. Unset keeps the task API loopback-only. See security.
TUI controls (in running session)
Type /captain for the full list. Pool modifiers: /oss (open weights) and /deterministic (ADI-green serving tuples, pinned). Mid-run: /btw <note> steers a running worker; /interrupt stops it and keeps a handoff or partial. /captain <leg|frontier|quality|auto|reset> switches the director helm live. See ADI and workflows.
Full tables live in the source tree as docs/CLI.md and configuration.