CLI flags
Synopsis
anthrogo [flags] [prompt]
Global flags
| Flag |
Default |
Description |
--version |
— |
Print version and exit |
-p, --print <text> |
— |
Headless mode: run prompt and exit (stdin is appended if piped) |
--json |
false |
Emit ndjson events instead of plain text (headless only) |
--model <name> |
provider default |
Override model for this session |
--provider <name> |
anthropic |
Active provider profile |
--permission-mode <mode> |
default |
default / acceptEdits / bypassPermissions / plan |
--cwd <path> |
current dir |
Override working directory |
--session <id> |
— |
Resume a specific session by UUID (or unambiguous prefix) |
--resume, -r <id> |
— |
Resume the specified session (alias for --session) |
--continue, -c |
false |
Continue the most recent session for this cwd |
--cost-limit <USD> |
0 |
Hard-cap estimated session cost; 0 = disabled |
--auto-compact <tokens> |
0 |
Auto-compact threshold in tokens; 0 = disabled |
--pprof <addr> |
— |
Start pprof server at addr (e.g. localhost:6060) for debug profiling |
--debug |
false |
Enable debug logging |
--no-color |
false |
Disable color output |
KAIROS worker flags
| Flag |
Description |
--kairos-serve <addr> |
Start a KAIROS worker on the given address (e.g. :9001) |
--signing-key <path> |
ed25519 private key file for SSE stream signing |
--trust-key <path\|base64> |
Trust a KAIROS worker public key (global) |
--tls-cert <path> |
TLS certificate file |
--tls-key <path> |
TLS private key file |
--tls-auto |
Enable Let's Encrypt autocert |
--tls-domain <domains> |
Comma-separated domains for autocert |
--generate-key <path> |
Generate an ed25519 keypair at the given path stem |
Subcommands
| Subcommand |
Description |
anthrogo init-config |
Interactive wizard to create ~/.anthrogo/settings.yaml |
anthrogo doctor |
Environment self-check (~20 checks; PASS/WARN/FAIL report) |
anthrogo serve |
Start the HTTP API daemon (REST/SSE) — see below |
anthrogo web |
Start the embedded browser UI — see below |
anthrogo serve
Start a long-lived HTTP server that exposes the engine as a REST/SSE API.
| Flag |
Default |
Description |
--addr |
127.0.0.1:8765 |
Listen address for the HTTP server |
--token |
— |
Bearer auth token; all routes require Authorization: Bearer <token> if set |
--cors-origin |
— |
Access-Control-Allow-Origin header value (e.g. https://myapp.com) |
--sessions-dir |
~/.anthrogo |
Override session storage directory |
--model |
settings.yaml |
Model alias override |
--provider |
settings.yaml |
Provider profile name override |
Endpoints:
| Method |
Path |
Description |
POST |
/v1/chat |
Send a message; stream: true enables SSE streaming |
GET |
/v1/sessions |
List recent sessions (up to 100) |
GET |
/v1/sessions/{id} |
Fetch full JSONL records for a session |
DELETE |
/v1/sessions/{id} |
Delete a session file |
GET |
/v1/tools |
List registered tools |
GET |
/v1/health |
Server health and uptime |
Quick check:
anthrogo serve &
curl http://127.0.0.1:8765/v1/health
anthrogo web
Start the embedded browser UI (vanilla JS SPA served via embed.FS). Automatically opens the browser unless --no-browser is set. Supports the same /v1/* API endpoints as serve, plus the SPA at /.
| Flag |
Default |
Description |
--addr |
auto (8766–8775) |
Listen address; auto-detects a free port in range 8766–8775 if not set |
--token |
— |
Bearer auth token |
--cors-origin |
— |
Access-Control-Allow-Origin header value |
--sessions-dir |
~/.anthrogo |
Override session storage directory |
--model |
settings.yaml |
Model alias override |
--provider |
settings.yaml |
Provider profile name override |
--no-browser |
false |
Do not open the browser automatically |
Examples
# Interactive TUI
anthrogo
# Headless — print assistant text
anthrogo -p "explain main.go"
# Headless — with piped stdin
git diff | anthrogo -p "summarize this diff"
# Headless — ndjson output
cat README.md | anthrogo --json -p "3 bullets" | jq -r '.text // empty'
# Accept file edits without asking
anthrogo --permission-mode acceptEdits -p "fix the typo in README"
# Override model
anthrogo --model claude-haiku-4-5-20251001
# Use a different provider profile
anthrogo --provider deepseek -p "summarize this repo"
# Start a KAIROS worker
KAIROS_AUTH_TOKEN=secret123 anthrogo --kairos-serve :9001