QA
team-attention/hoyeon
Systematically QA test any application — web apps, native macOS apps, Electron apps, CLI tools, interactive REPLs, or anything on screen.
Runs a read-only health check for cmux and explains what it finds, covering the CLI and socket, settings, agent hooks, session restore and notifications.
Install cmux Diagnostics
$ npx skills add manaflow-ai/cmux --skill cmux-diagnostics -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install manaflow-ai/cmux cmux-diagnostics --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/manaflow-ai/cmux.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/cmux-diagnostics .claude/skills/cmux-diagnostics && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "cmux-diagnostics" agent skill from https://github.com/manaflow-ai/cmux/tree/main/skills/cmux-diagnostics into .claude/skills/cmux-diagnostics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cmux-diagnostics", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/manaflow-ai/cmux/tree/main/skills/cmux-diagnosticsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add manaflow-ai/cmux --skill cmux-diagnostics -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install manaflow-ai/cmux cmux-diagnostics --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/manaflow-ai/cmux.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/cmux-diagnostics .agents/skills/cmux-diagnostics && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "cmux-diagnostics" agent skill from https://github.com/manaflow-ai/cmux/tree/main/skills/cmux-diagnostics into .agents/skills/cmux-diagnostics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cmux-diagnostics", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add manaflow-ai/cmux --skill cmux-diagnostics -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install manaflow-ai/cmux cmux-diagnostics --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/manaflow-ai/cmux.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/cmux-diagnostics .cursor/skills/cmux-diagnostics && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "cmux-diagnostics" agent skill from https://github.com/manaflow-ai/cmux/tree/main/skills/cmux-diagnostics into .cursor/skills/cmux-diagnostics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cmux-diagnostics", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/manaflow-ai/cmux.git --path skills/cmux-diagnostics--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add manaflow-ai/cmux --skill cmux-diagnostics -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install manaflow-ai/cmux cmux-diagnostics --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/manaflow-ai/cmux.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/cmux-diagnostics .gemini/skills/cmux-diagnostics && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "cmux-diagnostics" agent skill from https://github.com/manaflow-ai/cmux/tree/main/skills/cmux-diagnostics into .gemini/skills/cmux-diagnostics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cmux-diagnostics", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install manaflow-ai/cmux cmux-diagnosticsInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add manaflow-ai/cmux --skill cmux-diagnostics -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/manaflow-ai/cmux.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/cmux-diagnostics .github/skills/cmux-diagnostics && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "cmux-diagnostics" agent skill from https://github.com/manaflow-ai/cmux/tree/main/skills/cmux-diagnostics into .github/skills/cmux-diagnostics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cmux-diagnostics", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add manaflow-ai/cmux --skill cmux-diagnostics -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install manaflow-ai/cmux cmux-diagnostics --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/manaflow-ai/cmux.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/cmux-diagnostics .opencode/skills/cmux-diagnostics && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "cmux-diagnostics" agent skill from https://github.com/manaflow-ai/cmux/tree/main/skills/cmux-diagnostics into .opencode/skills/cmux-diagnostics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cmux-diagnostics", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
cmux-diagnostics- GitHub stars
- 28k
- Used in
- 1 other repo
- Token cost
- ~819 tokens
- SKILL.md length
- 374 words
- Files
- 3 (incl. scripts)
- Skills in repo
- 22
- Repo updated
- First seen
- Licence
- Custom licence
At a glance
Runs a read-only health check for cmux and explains what it finds, covering the CLI and socket, settings, agent hooks, session restore and notifications.
- Works in 5 steps: CLI and socket health: command -v cmux,… → Settings health: cmux-settings validate… → Hook installation: cmux hooks setup… → …
- cmux notifications or agent hooks stop working
- SKILL.md covers Quick report, What to check, Interpretation and Rules
- Agent sessions are not resuming after panes are restored
What it does
The agent starts with the bundled `cmux-diagnostics` script, found in the cmux checkout or in an installed-skill path, and keeps to read-only checks. It adds `--include-context` only when workspace names, working directories and cmux identifiers matter to the reported problem. Hook config files, session stores, prompt logs, tokens and environment secrets are never dumped, so the output is safe to pass to support.
Manual checks follow a set order: whether the CLI is on PATH and the socket answers `cmux ping`, whether the settings validate and `terminal.autoResumeAgentSessions` is enabled, whether hooks are installed for agents such as Codex and OpenCode, whether session-restore files exist, and a visible test notification when you are ready for one. An interpretation list maps symptoms to causes, for example a failed ping meaning the app is closed or automation access is off, or missing workspace variables meaning the command ran outside a cmux terminal. Installing or removing hooks happens only after you agree.
When your agent uses it
- cmux notifications or agent hooks stop working
- Agent sessions are not resuming after panes are restored
- Preparing a support-safe debug summary of a cmux setup
- Running a cmux health check or doctor report
Example prompts
- “Run a cmux health check and tell me why my notifications never show up.”
- “My Codex sessions don't resume after restarting cmux, so please diagnose it.”
- “Give me a support-safe doctor report for cmux that I can paste into a bug report.”
Requirements
- cmux with its CLI on PATH
- The cmux app running, for the socket checks
Workflow steps
5 steps, taken from the first numbered list in SKILL.md.
- CLI and socket health: command -v cmux, cmux ping, cmux capabilities --json. If socket commands fail, check whether the agent is running…
- Settings health: cmux-settings validate and cmux-settings get terminal.autoResumeAgentSessions (from…
- Hook installation: cmux hooks setup --agent codex, --agent opencode, or bare cmux hooks setup (installs supported agents found on PATH…
- Session restore evidence: ls -lh ~/.cmuxterm/*-hook-sessions.json 2>/dev/null. Missing stores usually mean the agent has not run inside…
- Notification path: cmux notify "cmux diagnostic test", only when the user is ready for a visible test notification.
What it can do on your machine
Read from SKILL.md and the folder at commit bbb3633. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 1 file in scripts/, which the agent can run.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
cmux Diagnostics loads about 819 tokens when it runs. Until then it costs about 73 tokens; SKILL.md has 374 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
SKILL.md
Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 374 words (~819 tokens).
“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.”
- name
- cmux-diagnostics
Files
SKILL.md and 2 other files (scripts) in skills/cmux-diagnostics of manaflow-ai/cmux.
- SKILL.md
- agents/openai.yaml
- scripts/cmux-diagnostics
Open the folder on GitHubat commit bbb3633
Used in 1 other repository
We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in manaflow-ai/cmux, which our catalogue first saw on October 7, 2026.
Compare with similar skills
cmux Diagnostics next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| cmux Diagnostics this skillmanaflow-ai/cmux | 28k | 1 repos | ~819 | Automated safety check: Pass | Custom licence | |
| QAteam-attention/hoyeon | 173 | — | ~2.6k | Automated safety check: Notes | MIT | |
| OpenLogi macOS Permissions TriageAprilNEA/OpenLogi | 23k | — | ~2.5k | Automated safety check: Notes | Apache-2.0 | |
| LangBot Plugin Developmentlangbot-app/LangBot | 18k | — | ~3.9k | Automated safety check: Pass | Apache-2.0 | |
| Apple Crash Log .NET Symbolicationdotnet/skills | 5.6k | 1 repos | ~2.4k | Automated safety check: Pass | MIT | |
| Peon-Ping Settings EditorPeonPing/peon-ping | 5.1k | — | ~1.2k | Automated safety check: Pass | MIT |
Similar skills
OpenLogi macOS Permissions Triage
AprilNEA/OpenLogi
Decides whether an OpenLogi device problem on macOS is a privacy-permission (TCC) problem, using agent log lines, and says which identity needs which grant.
LangBot Plugin Development
langbot-app/LangBot
Guides building, debugging and testing LangBot plugins: components, SDK calls, README and locale rules, SDK pitfalls and WebSocket-based testing.
- Official
Apple Crash Log .NET Symbolication
dotnet/skills
Resolves .NET runtime frames in Apple .ips crash logs to function names, source files and line numbers using dSYM symbols, atos and the Microsoft symbol server.
Peon-Ping Settings Editor
PeonPing/peon-ping
Edits the peon-ping config file to change volume, sound packs, pack rotation, sound categories and notification options, then confirms the change.
- Official
.NET Crash Dump Collection
dotnet/skills
Configures automatic crash dumps or captures dumps from running processes for modern .NET apps on Linux, macOS and Windows, including Docker and Kubernetes.
More from manaflow-ai/cmux
All 22 skills in this repocmux Settings Editor
manaflow-ai/cmux
Reads and changes cmux preferences in `~/.config/cmux/cmux.json` through a helper that validates each change before writing, covering terminal, browser, viewers and shortcuts.
cmux Backend Rules
manaflow-ai/cmux
Sets the backend TypeScript and Cloud VM rules for cmux: Effect-based services, thin route handlers, Postgres as source of truth, migrations and provider secrets.
Cmux Debugging Guide
manaflow-ai/cmux
Covers debug logging, the Debug menu, profiling rules and runtime pitfalls for working on the cmux macOS terminal app.
Ghostty Submodule and GhosttyKit Workflow
manaflow-ai/cmux
Workflow rules for the Ghostty submodule in cmux: rebuilding GhosttyKit.xcframework, pushing fork changes and updating the parent submodule pointer safely.
Cmux Release Workflow
manaflow-ai/cmux
Runs the cmux release process: gathers per-PR changelog lines since the last tag, bumps the version, guards against a bad tag, then tags and pushes the macOS DMG release.
cmux Browser Surface Control
manaflow-ai/cmux
Opens, inspects, and drives a browser surface through the cmux CLI without stealing the user's focus, always targeting an explicit surface handle.
Related
Works with
Categories
Questions about cmux Diagnostics
What does cmux Diagnostics do?
Runs a read-only health check for cmux and explains what it finds, covering the CLI and socket, settings, agent hooks, session restore and notifications. The agent starts with the bundled `cmux-diagnostics` script, found in the cmux checkout or in an installed-skill path, and keeps to read-only checks. It adds `--include-context` only when workspace names, working directories and cmux identifiers matter to the reported problem.
When should I use cmux Diagnostics?
cmux Diagnostics fits situations like: cmux notifications or agent hooks stop working; agent sessions are not resuming after panes are restored; preparing a support-safe debug summary of a cmux setup; running a cmux health check or doctor report.
How do I install cmux Diagnostics in Claude Code?
Run `npx skills add manaflow-ai/cmux --skill cmux-diagnostics -a claude-code`. Or copy the skill folder (skills/cmux-diagnostics in manaflow-ai/cmux) into .claude/skills/cmux-diagnostics in your project. Claude Code loads it when a task matches its description.
How do I install cmux Diagnostics in Codex?
Run `npx skills add manaflow-ai/cmux --skill cmux-diagnostics -a codex`. Or copy the skill folder (skills/cmux-diagnostics in manaflow-ai/cmux) into .agents/skills/cmux-diagnostics in your project. Codex loads it when a task matches its description.
Can I use cmux Diagnostics in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add manaflow-ai/cmux --skill cmux-diagnostics -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cmux-diagnostics, .gemini/skills/cmux-diagnostics, .github/skills/cmux-diagnostics and .opencode/skills/cmux-diagnostics in your project.
What does cmux Diagnostics need to run?
SKILL.md names no scripts, command-line tools or credentials: cmux Diagnostics is instructions for the agent only. Our summary lists: cmux with its CLI on PATH; The cmux app running, for the socket checks.
Does cmux Diagnostics access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is cmux Diagnostics safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does cmux Diagnostics use?
cmux Diagnostics has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.
How many tokens does cmux Diagnostics use?
About 819 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to cmux Diagnostics?
Skills that share tags, products or a category with cmux Diagnostics: QA (team-attention/hoyeon, 173 stars), OpenLogi macOS Permissions Triage (AprilNEA/OpenLogi, 23k stars), LangBot Plugin Development (langbot-app/LangBot, 18k stars) and Apple Crash Log .NET Symbolication (dotnet/skills, 5.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains cmux Diagnostics?
manaflow-ai (a GitHub organization) maintains it in manaflow-ai/cmux, which has 28,076 GitHub stars. The repository holds 22 skills in this directory. The repository was last updated on October 10, 2026.
Source: manaflow-ai/cmux on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.