cmux-diagnosticslisted
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