Honcho CLI
Inspects Honcho workspaces, peer memory and session context from the CLI.
Install
npx skills add plastic-labs/honcho --skill honcho-cli -g -a claude-code -y- Repository
- plastic-labs/honcho7.9k
- Category
- Data and ML
- Updated
- 3d ago
- License
- AGPL-3.0
- Context cost
- Lightabout 1,161 tokens
- Runs scripts
- No, instructions only
What it does
Inspect and debug Honcho workspaces via the `honcho` CLI. Use when investigating peer representations, memory state, session context, or dialectic quality, any task that requires introspection of a Honcho deployment, including verifying that a recall/record memory loop is actually working.
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:
0success ·1client error (bad input, not found) ·2server error ·3auth error - Config:
~/.honcho/config.json(shared with other Honcho tools). The CLI ownsapiKeyandenvironmentUrlat the top level; runhoncho initto confirm or set them. Per-command scope (workspace / peer / session) is via-w/-p/-sflags orHONCHO_*env vars.
Command groups
honcho config, CLI configurationhoncho start/stop/status, local Docker stack (does not changeenvironmentUrl). First start pins the Honcho image digest and writesconfig.tomlinto the profile. Pass--setup basicor--setup advancedfor an interactive config wizard (TTY only; writes.envoverrides).honcho statuslists every profile; pass--profilefor one.honcho workspace, inspect, delete, search, chathoncho peer, inspect, card, chat, searchhoncho session, inspect, view (transcript), context, summarieshoncho scope, list, create, inspect, sessions, add-sessions, remove-session, statushoncho message, list and gethoncho conclusion, list, search, create, delete
