ccb-self-diagnose

Solid

Diagnose CCB runtime, mounted daemon graph, tmux namespace and panes, provider context, queue/inbox/trace, replies/artifacts, config drift, and storage boundaries. Use when the user asks what is broken, which agent is stuck, whether CCB is mounted, why a reply did not arrive, or what to check first.

AI & Automation 3,329 stars 323 forks Updated today NOASSERTION

Install

View on GitHub

Quality Score: 83/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# CCB Self Diagnose Use this skill for read-only triage. Prefer CCB control-plane diagnostics and read-only tmux evidence. Do not mutate runtime state from this skill. ## Evidence Model Keep these categories separate in every diagnosis: - Authority: current mounted daemon service graph, lifecycle, lease, current configured-agent runtime records, and loaded config. - Evidence: `ccb ping`, `ccb doctor`, `ccb ps`, `ccb queue`, `ccb pend`, `ccb trace`, `ccb fault list`, `ccb doctor logs <agent>`, reply/artifact records, tmux pane metadata/text capture, provider session files, pid files, and config validation or reload dry-run output. - Residue: disk-only `.ccb/agents/*` directories for unknown agents, stale panes, stale sockets, old session artifacts, dead helpers, and orphaned provider state. Configured-agent and restart target authority comes from the mounted daemon graph, not disk config, tmux panes, or `.ccb/agents/*` residue. ## Core Workflow 1. Confirm the project anchor and current mounted daemon generation. 2. Gather the control-plane snapshot: - `ccb ping ccbd` - `ccb doctor` - `ccb ps` - `ccb queue --detail all` - `ccb fault list` - `ccb pend --inbox --detail <agent>` when one agent is suspected - `ccb trace <job_id|message_id|attempt_id|reply_id>` for lineage issues - `ccb doctor logs <agent>` when provider/API evidence is needed 3. Gather read-only tmux evidence when pane or provider state matters: - current CCB tmux names...

Details

Author
SeemSeam
Repository
SeemSeam/claude_codex_bridge
Created
9 months ago
Last Updated
today
Language
Python
License
NOASSERTION

Similar Skills

Semantically similar based on skill content — not just same category