Agent Skills › plastic-labs/honcho › honcho-cli

honcho-cli

GitHub

通过 honcho CLI 检查与调试 Honcho 工作区。用于调查对等体表示、内存状态、会话上下文、队列状态及辩证质量，支持以 JSON 格式输出进行程序化处理。

.claude/skills/honcho-cli/SKILL.md plastic-labs/honcho

Trigger Scenarios

需要检查 Honcho 工作区或部署状态调试对等体（peer）内存或记忆问题排查会话上下文错误或消息历史诊断辩证过程（dialectic）生成错误答案检查工作区队列状态或推导停滞

Install

npx skills add plastic-labs/honcho --skill honcho-cli -g -y

More Options

Non-standard path

npx skills add https://github.com/plastic-labs/honcho/tree/main/.claude/skills/honcho-cli -g -y

Use without installing

npx skills use plastic-labs/honcho@honcho-cli

指定 Agent (Claude Code)

npx skills add plastic-labs/honcho --skill honcho-cli -a claude-code -g -y

安装 repo 全部 skill

npx skills add plastic-labs/honcho --all -g -y

预览 repo 内 skill

npx skills add plastic-labs/honcho --list

SKILL.md

Frontmatter

{
    "name": "honcho-cli",
    "description": "Inspect and debug Honcho workspaces via the `honcho` CLI. Use when investigating peer representations, memory state, session context, queue status, or dialectic quality — any task that requires introspection of a Honcho deployment.",
    "allowed-tools": "Bash(honcho:*), Bash(jq:*), Read, Grep"
}

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 workspace — inspect, delete, search
honcho peer — inspect, card, chat, search
honcho session — inspect, messages, context, summaries
honcho message — list and get
honcho conclusion — list, search, create, delete

Rules

Always pass --json when processing output programmatically.
Run honcho peer inspect before honcho peer chat to understand context.
Use honcho session context to see exactly what an agent receives.
Never run honcho workspace delete without honcho workspace inspect first.
Check queue status when derivation seems stalled.
Compare peer card with conclusions to understand memory state.

Inspection tour

When orienting to a Honcho deployment, walk outside-in:

1. Understand the workspace

honcho workspace inspect --json

2. Find the peer

honcho peer list --json
honcho peer inspect <peer_id> --json

3. Check peer's memory

honcho peer card <peer_id> --json
honcho conclusion list --observer <peer_id> --json
honcho conclusion search "topic" --observer <peer_id> --json

4. Debug a session

honcho session inspect <session_id> --json
honcho message list <session_id> --last 20 --json
honcho session context <session_id> --json
honcho session summaries <session_id> --json

5. Search across workspace

honcho workspace search "query" --json
honcho peer search <peer_id> "query" --json

Debugging playbook

Peer not learning?

# Is observation enabled?
honcho peer inspect <peer_id> --json | jq '.configuration'

# Is the deriver queue processing messages?
honcho workspace queue-status --json

# What conclusions exist?
honcho conclusion list --observer <peer_id> --json
honcho conclusion search "expected topic" --observer <peer_id> --json

Session context looks wrong?

# Raw context an agent would receive
honcho session context <session_id> --json

# Summaries feeding the context
honcho session summaries <session_id> --json

# Recent message history
honcho message list <session_id> --last 50 --json

Dialectic giving bad answers?

# What the peer card says
honcho peer card <peer_id> --json

# Conclusions on the specific topic
honcho conclusion search "topic" --observer <peer_id> --json

# Exercise the dialectic directly
honcho peer chat <peer_id> "what do you know about X?" --json