{/* GENERATED by honcho-cli/scripts/generate_cli_docs.py — do not edit. Re-generate with: uv run --package honcho-cli python honcho-cli/scripts/generate_cli_docs.py Source of truth: honcho-cli/src/honcho_cli/commands/ */} ## honcho conclusion List, search, create, and delete peer conclusions (Honcho's memory atoms). Create a conclusion. ```bash honcho conclusion create ``` Observer peer ID. Observed peer ID. Session context. Short alias: `-s`. Delete a conclusion. ```bash honcho conclusion delete ``` Observer peer ID. Observed peer ID. Skip confirmation. Short alias: `-y`. List conclusions. ```bash honcho conclusion list ``` Observer peer ID. Observed peer ID. Max results. Semantic search over conclusions. ```bash honcho conclusion search ``` Observer peer ID. Observed peer ID. Max results. ## honcho config Inspect CLI configuration. ```bash honcho config ``` ## honcho doctor Verify config and connectivity. Scope with -w / -p to check workspace, peer, and queue health. ```bash honcho doctor ``` ## honcho help Show help message. ```bash honcho help ``` ## honcho init Set API key and server URL in ~/.honcho/config.json. Press Enter to keep the current value or type a replacement. Workspace / peer / session scoping is per-command via -w / -p / -s or HONCHO_* env vars — never persisted. ```bash honcho init ``` API key (admin JWT). Honcho API URL (e.g. https://api.honcho.dev, http://localhost:8000). ## honcho message List, create, and get messages within a session. Create a message in a session. ```bash honcho message create ``` Peer ID of the message sender. Short alias: `-p`. JSON metadata to associate with the message. Session ID. Short alias: `-s`. Get a single message by ID. ```bash honcho message get ``` Session ID. Short alias: `-s`. List messages in a session. Scoped to a peer with -p. ```bash honcho message list [] ``` Number of recent messages. Show oldest first (default is newest first). Show only IDs, peer, token count, and created_at (no content). Filter by peer ID. Short alias: `-p`. ## honcho peer List, create, chat with, search, and manage peers and their representations. Get raw peer card content. ```bash honcho peer card [] ``` Target peer for relationship card. Query the dialectic about a peer. ```bash honcho peer chat ``` Target peer for perspective. Reasoning level: minimal, low, medium, high, max. Short alias: `-r`. Create or get a peer. ```bash honcho peer create ``` Whether Honcho will form a representation of this peer. Negate with `--no-observe-me`. JSON metadata to associate with the peer. Get metadata for a peer. ```bash honcho peer get-metadata [] ``` Inspect a peer: card, session count, recent conclusions. ```bash honcho peer inspect [] ``` List all peers in the workspace. ```bash honcho peer list ``` Get the formatted representation for a peer. ```bash honcho peer representation [] ``` Target peer to get representation about. Semantic search query to filter conclusions. Maximum number of conclusions to include. Search a peer's messages. ```bash honcho peer search ``` Max results. Set metadata for a peer. ```bash honcho peer set-metadata ``` Peer ID (uses default if omitted). Short alias: `-p`. ## honcho session List, inspect, view, create, delete, and manage conversation sessions and their peers. Add peers to a session. ```bash honcho session add-peers ``` Get session context (what an agent would see). ```bash honcho session context [] ``` Token budget. Include summary. Negate with `--no-summary`. Create or get a session. ```bash honcho session create ``` Comma-separated peer IDs to add to the session. JSON metadata to associate with the session. Delete a session and all its data. Destructive — requires --yes or interactive confirm. ```bash honcho session delete [] ``` Skip confirmation. Short alias: `-y`. Get metadata for a session. ```bash honcho session get-metadata [] ``` Inspect a session: peers, message count, summaries, config. ```bash honcho session inspect [] ``` List sessions in the workspace. ```bash honcho session list ``` Filter by peer. Short alias: `-p`. List peers in a session. ```bash honcho session peers [] ``` Remove peers from a session. ```bash honcho session remove-peers ``` Get the representation of a peer within a session. ```bash honcho session representation [] ``` Target peer (what peer_id knows about target). Semantic search query to filter conclusions. Maximum number of conclusions to include. Search messages in a session. ```bash honcho session search [] ``` Max results. Set metadata for a session. ```bash honcho session set-metadata [] ``` JSON metadata to set (e.g. '\{"key": "value"\}'). Short alias: `-d`. Get session summaries (short + long). ```bash honcho session summaries [] ``` View a session transcript as a chat log. Modes (pick one): - default / --last N: tail of the conversation (most recent N) - --page N [--size M]: page through the full transcript - --all: every message Paging follows the requested order: --page 1 starts at the oldest message, or the newest with --reverse. Human mode prints a row-delimited table. JSON mode emits the message list (same shape as message list). ```bash honcho session view [] ``` Show only the N most recent messages (default when no --page/--all: 50). 1-indexed page of the full transcript. Use for page 2+. Messages per page; requires --page (1-100, default: 50). Show the full transcript (every page). Newest first (default is chronological: oldest at top). Include message IDs in the transcript. Filter by peer ID. Short alias: `-p`. ## honcho start Start a local Honcho stack (API, deriver, Postgres, Redis). Requires Docker. Uses cloud LLM providers. Does not change the CLI's configured server URL — pass HONCHO_BASE_URL to talk to this stack. ``--setup basic`` or ``--setup advanced`` runs an interactive config wizard. ```bash honcho start ``` Local stack profile name. Host port for the API. Host port for Postgres. Host port for Redis. Interactive config wizard: basic (provider/model) or advanced (embeddings, deriver, dialectic, dreams, flush). Honcho image to pull and pin by digest (default: ghcr.io/plastic-labs/honcho:latest). Seconds to wait for /health after compose up. ## honcho status Show local stack endpoints and container health. With no ``--profile``, lists every stack under ``~/.honcho/profiles/``. ```bash honcho status ``` Limit to this profile. Omit to show every local stack. ## honcho stop Stop the local stack started by `honcho start`. Keeps data unless --wipe. ```bash honcho stop ``` Local stack profile name. Also delete volumes (Postgres data). ## honcho workspace List, create, inspect, delete, and search workspaces. Create or get a workspace. ```bash honcho workspace create ``` JSON metadata to associate with the workspace. Delete a workspace. Use --dry-run first to see what will be deleted. Requires --yes to skip confirmation, or will prompt interactively. If sessions exist, requires --cascade to delete them first. ```bash honcho workspace delete ``` Skip confirmation prompt (for scripted/agent use). Short alias: `-y`. Delete all sessions before deleting the workspace. Show what would be deleted without deleting. Inspect a workspace: peers, sessions, config. ```bash honcho workspace inspect [] ``` List all accessible workspaces. ```bash honcho workspace list ``` Get queue processing status. ```bash honcho workspace queue-status ``` Filter by observer peer. Filter by sender peer. Search messages across workspace. ```bash honcho workspace search ``` Max results.