← ClaudeAtlas

cmux-diagnosticslisted

Run end-user cmux diagnostics. Use when cmux hooks, notifications, session restore, settings, browser automation, socket access, CLI control, or agent resume behavior is not working, or when the user asks for a cmux health check, doctor report, or support-safe debug summary.
manaflow-ai/cmux · ★ 20,069 · Web & Frontend · score 79
Install: claude install-skill manaflow-ai/cmux
# cmux Diagnostics Use this skill to collect and interpret support-safe cmux diagnostics for end users. Default to read-only checks. Do not dump hook config files, session stores, prompt logs, tokens, or environment secrets. ## Quick Report Run the bundled read-only diagnostic script first: ```bash # From a cmux checkout skills/cmux-diagnostics/scripts/cmux-diagnostics # From an installed skill ~/.agents/skills/cmux-diagnostics/scripts/cmux-diagnostics # From a Codex-only skills.sh install ~/.codex/skills/cmux-diagnostics/scripts/cmux-diagnostics ``` Use `--include-context` only when workspace names, cwd paths, and current cmux identifiers are relevant to the user-reported issue: ```bash skills/cmux-diagnostics/scripts/cmux-diagnostics --include-context ``` ## What to Check 1. CLI and socket health: ```bash command -v cmux cmux ping cmux capabilities --json ``` If socket commands fail, check whether the agent is running inside a cmux terminal and whether socket automation is enabled. 2. Settings health: ```bash ~/.agents/skills/cmux-settings/scripts/cmux-settings validate ~/.agents/skills/cmux-settings/scripts/cmux-settings get terminal.autoResumeAgentSessions ``` If the user installed with `skills.sh`, use `~/.codex/skills/cmux-settings/scripts/cmux-settings` instead. If `terminal.autoResumeAgentSessions` is false, cmux restores panes but will not automatically resume saved agent sessions. 3. Hook installation: ```bash