{/* 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, 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 [] ``` ## 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.