cmux-diagnostics

Solid

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.

Web & Frontend 25,245 stars 2089 forks Updated today NOASSERTION

Install

View on GitHub

Quality Score: 79/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

# 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: ```bash 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. ## What to check 1. **CLI and socket health**: `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**: `cmux-settings validate` and `cmux-settings get terminal.autoResumeAgentSessions` (from `~/.agents/skills/cmux-settings/scripts/`, or `~/.codex/skills/...` for a `skills.sh` install). When `terminal.autoResumeAgentSessions` is false, cmux restores panes but does not resume saved agent sessions. 3. **Hook installation**: `cmux hooks setup --agent codex`, `--agent opencode`, or bare `cmux hooks setup` (installs supported agents found on PATH, skips missing ones). Run install or uninstall commands only after the user agrees. 4. **Session restore eviden...

Details

Author
manaflow-ai
Repository
manaflow-ai/cmux
Created
6 months ago
Last Updated
today
Language
Swift
License
NOASSERTION

Similar Skills

Semantically similar based on skill content — not just same category