Cmux Diagnostics

When cmux hooks stop firing, sessions don't restore, or notifications vanish into the void, this skill runs the diagnostics script and walks you through socket health, settings validation, hook installation state, and session store evidence. It defaults to read-only checks and won't dump your prompt logs or tokens into the transcript. The bundled script lives in three possible locations depending on whether you installed via checkout, agents, or Codex skills.sh. Most useful when a user reports "cmux used to work and now it doesn't" and you need a structured way to check the usual suspects without asking them to paste their entire dotfile setup.

skills.sh installs: 6.6K
GitHub stars: 28.7K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add manaflow-ai/cmux --skill cmux-diagnostics --agent claude-code

Installs into .claude/skills of the current project.

Files

cmux Diagnostics

Collect and interpret support-safe cmux diagnostics for end users. Default to read-only checks. Never dump hook config files, session stores, prompt logs, tokens, or environment secrets.

Quick report

Run the bundled read-only script first, from whichever install path exists:

skills/cmux-diagnostics/scripts/cmux-diagnostics            # cmux checkout
~/.agents/skills/cmux-diagnostics/scripts/cmux-diagnostics  # installed skill
~/.codex/skills/cmux-diagnostics/scripts/cmux-diagnostics   # Codex-only skills.sh install

Add --include-context only when workspace names, cwd paths, and current cmux identifiers are relevant to the reported issue.