...
you@honcho-cli ~ %
v0.1.0
getting started
honcho init
configure API key and server URL
honcho doctor
verify connection and workspace health
commands
pattern
honcho <command> [args] [-w workspace] [-p peer] [-s session]
example
honcho peer chat "what does alice prefer?" -p alice -w slack
workspace
list · create · search · delete · inspect · queue-status
peer
list · create · search · inspect · card · chat get-metadata · set-metadata · representation
session
list · create · search · delete · inspect · add-peers context · get-metadata · set-metadata · peers remove-peers · representation · summaries
message
list · create · get
conclusion
list · create · search · delete
config
inspect current configuration

See it in action.

Four primitives the CLI optimizes for — scriptable, composable, and built to be driven by agents as readily as by humans.

View on GitHubRead the docs
you@honcho-cli ~ %
demo · 1/5 · text
[Features]

Built for the shape of real work.

Memory that reasons, not just recalls

Query the dialectic API directly. honcho peer chat returns answers grounded in a peer's full representation — not retrieval, reasoning.

Agent-friendly output

Every command emits JSON when stdout isn't a TTY or when --json is forced. Structured errors with stable error codes.

Scoped by design

Workspace / peer / session scoping via -w / -p / -s flags or HONCHO_* env vars. Set once per shell, or pass per-command.

Shared config with the rest of Honcho

Reads and writes ~/.honcho/config.json — the same file plugins, host integrations, and SDKs use. One setup, everything works.

Install

Three seconds to the first command.

$ uv tool install honcho-cli
View on GitHubRead the docs