# Honcho CLI

Inspects Honcho workspaces, peer memory and session context from the CLI.

- Repository: https://github.com/plastic-labs/honcho (7877 stars)
- Category: Data and ML
- License: AGPL-3.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add plastic-labs/honcho --skill honcho-cli -g -a claude-code -y`
Codex: `npx skills add plastic-labs/honcho --skill honcho-cli -g -a codex -y`
Cursor: `npx skills add plastic-labs/honcho --skill honcho-cli -g -a cursor -y`
Gemini CLI: `npx skills add plastic-labs/honcho --skill honcho-cli -g -a gemini-cli -y`

## Description

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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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 start` / `stop` / `status`, local Docker stack (does not change `environmentUrl`). First start pins the Honcho image digest and writes `config.toml` into the profile. Pass `--setup basic` or `--setup advanced` for an interactive config wizard (TTY only; writes `.env` overrides). `honcho status` lists every profile; pass `--profile` for one.
- `honcho workspace`, inspect, delete, search, chat
- `honcho peer`, inspect, card, chat, search
- `honcho session`, inspect, view (transcript), context, summaries
- `honcho scope`, list, create, inspect, sessions, add-sessions, remove-session, status
- `honcho message`, list and get
- `honcho conclusion`, list, search, create, delete

## Rules

The rest: https://github.com/plastic-labs/honcho/blob/HEAD/skills/honcho-cli/SKILL.md