cmux-diagnostics
cmux diagnostics
What it does
- cmux not found: the CLI is not installed or not on PATH for this shell.
- cmux ping fails: app is not reachable through the current socket path, the app is closed, or automation access is disabled.
- No CMUXWORKSPACEID or CMUXSURFACEID: the command is probably running outside a cmux terminal. Some hooks intentionally no-op outside cmux.
- Hook config exists but no session store: run one supported agent inside cmux after installing hooks, then re-check.
- Session store exists but restore does not launch agents: check terminal.autoResumeAgentSessions and whether the saved executable still exists on PATH.
- Settings validation fails: fix the config first. Invalid config can make later symptoms misleading.
- Stay read-only until the user asks to fix something.
Requirements & configuration
Configuration: CMUX_WORKSPACE_IDCMUX_SURFACE_ID
Derived from the skill's own SKILL.md documentation · extracted 2026-07-23
cmux-diagnostics FAQ
What does the cmux-diagnostics skill do?
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. cmux not found: the CLI is not installed or not on PATH for this shell. cmux ping fails: app is not reachable through the current socket path, the app is closed, or automation access is disabled.
What does cmux-diagnostics require?
Configuration keys: CMUX_WORKSPACE_ID, CMUX_SURFACE_ID.
How do I install cmux-diagnostics?
Run: npx -y skills add https://github.com/manaflow-ai/cmux --skill cmux-diagnostics --agent claude-code — the source lives at github.com/manaflow-ai/cmux.
Maintain cmux-diagnostics?
Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.
[cmux-diagnostics on getagentictools](https://getagentictools.com/skills/manaflow-ai-cmux-cmux-diagnostics?ref=badge) npx agentictools info skills/manaflow-ai-cmux-cmux-diagnostics The second line is the CLI lookup for this page — handy in READMEs and docs.
