CLI reference
Binary names: sage · agentic-sage (same entry).
Run sage --help / sage <verb> --help for the live surface. Below is the product map.
Everyday
| Command | Purpose |
|---|---|
sage board |
Per-repo session board (must be inside a judged git repo) |
sage war |
Cross-repo war-room cockpit (TTY interactive) |
sage doctor |
Health checks + fix hints |
sage status |
Compact status / wiring summary |
Install & lifecycle
| Command | Purpose |
|---|---|
sage init |
Bootstrap hooks/templates for this machine |
sage on / sage off |
Global judging switch |
sage enable / sage disable |
Project-scoped judging |
sage uninstall |
Surgical remove (see uninstall/README.md) |
Coordination (optional)
| Command | Purpose |
|---|---|
sage territory / why-diverged / merge-brief |
Collision facts for workers |
sage claim / sage backlog |
Register intent / backlog rows |
sage guard |
Contested-path hard stop (default OFF) |
sage link / sage unlink |
Manual link_state helpers |
Live judge (optional)
Optional Claude/Grok pane that reasons and writes continuous briefs. Core stays passive — no LLM in Node.
| Command | Purpose |
|---|---|
sage judge run […] |
Easy start — auto scope + harness spawn (or fact-only keeper) |
sage judge on --fleet|--repo [--takeover] |
Mark this session as live judge |
sage judge off |
Clear role; mark brief stale |
sage judge publish |
Stdin JSON → atomic brief write |
sage judge status / show |
Freshness + print brief |
judge run flags: --auto|--fleet|--repo, --harness auto|grok|claude|none, --once, --takeover, --print-only.
Consult verbs layer fresh briefs after facts (repo then fleet). After judge exit, briefs stay attachable for ~30s grace. War shows a ⚖ chip when a judge/brief is active. Skill: sage-judge. Recipe: Live judge.
Statusline
| Command | Purpose |
|---|---|
sage statusline |
Emit / install statusline segment (Claude / tmux consumers) |
Safety
SAGE is passive. CLI verbs that look active (init, enable, statusline install) only touch SAGE’s own wiring and store, not your application source as an agent would.
Full narrative: README — Safety · SETUP.md
Machine JSON
Board / fleet machine envelopes: SCHEMA.md