Skip to content

First run

This guide takes you from a fresh install to a working anthrogo session in about 5 minutes.

Step 1 — Set your API key

export ANTHROPIC_API_KEY=sk-ant-...

Or add it to ~/.anthrogo/settings.yaml (created in step 2):

apiKey: sk-ant-...

Step 2 — Generate your settings file

anthrogo init-config

The interactive wizard asks for your API key, default model, and permission mode, then writes ~/.anthrogo/settings.yaml. Use --force to overwrite an existing file.

Step 3 — Verify your environment

anthrogo doctor

Runs ~20 checks and prints a structured PASS / WARN / FAIL report:

[✓] Go runtime                    running on go1.25.0 (darwin/arm64)
[✓] Settings file                 found at /Users/you/.anthrogo/settings.yaml
[✓] API key: ANTHROPIC_API_KEY    set (anthropic)
[✓] Anthrogo home                 /Users/you/.anthrogo ok
[!] Binary: docker                not on PATH (ContainerExec tool)
[!] Binary: whisper               not on PATH (SpeechToText tool)
[✓] Anthropic API                 HTTP 200
[✓] anthrogo version              0.13.0-dev

Summary: 7 PASS, 2 WARN, 0 FAIL

Exit code is 1 when any check is FAIL, 0 otherwise. WARN means an optional feature is unavailable, not that the core CLI is broken.

Step 4 — Launch the TUI

anthrogo

The Bubble Tea TUI opens. Type a prompt and press Enter. Press F2 to cycle pane layouts (single / split / triple). Press Up/Down to scroll through input history.

Step 5 — Try compaction

After a long session, run /compact to summarize older turns and reduce token cost:

/compact

Or set auto_compact_threshold: 150000 in settings.yaml to trigger automatically.

Headless mode

For scripting, skip the TUI:

anthrogo -p "explain main.go"
anthrogo --permission-mode acceptEdits -p "fix the typo in README"
git diff | anthrogo -p "summarize this diff"
echo "what is 2+2?" | anthrogo -p

The --json flag emits one JSON object per line (ndjson) — useful for piping to jq:

cat README.md | anthrogo --json -p "describe in 3 bullets" | jq -r '.text // empty'

Useful first commands

Once in the TUI:

Command Effect
/help List all slash commands
/cost Show token usage and estimated cost
/compact Summarize older turns
/sessions List saved sessions
/version Print version + check for updates
/theme set light Switch to light theme
/mcp List connected MCP servers