Honcho CLI

honcho wraps the Honcho Python SDK with agent-friendly defaults: JSON output, structured errors, input validation. Use it to inspect workspace state, debug peer memory, and diagnose the dialectic.

Output & config

• TTY: human-readable tables (default when interactive)
• Piped / --json: JSON — collection commands emit arrays, single-resource commands emit objects
• Exit codes: 0 success · 1 client error (bad input, not found) · 2 server error · 3 auth error
• Config: ~/.honcho/config.json (shared with other Honcho tools). The CLI owns apiKey and environmentUrl at the top level; run honcho init to confirm or set them. Per-command scope (workspace / peer / session) is via -w / -p / -s flags or HONCHO_* env vars.

Command groups

• honcho config — CLI configuration
• honcho workspace — inspect, delete, search
• honcho peer — inspect, card, chat, search
• honcho session — inspect, messages, context, summaries
• honcho message — list and get
• honcho conclusion — list, search, create, delete