Skip to main content
affpapa.org
RU EN
skill Claude Code CX Codex Cursor GitHub Copilot

cmux-diagnostics — Claude Code skill: cmux health check

Skill runs read-only cmux diagnostics: sockets, hooks, session restore, settings. Use when notifications fail, agents don't resume, or you need a support-safe debug report.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add manaflow-ai/cmux --skill cmux-diagnostics -a claude-code
Open on GitHub

What cmux-diagnostics does

cmux-diagnostics collects diagnostics in read-only mode and never exposes secrets, tokens, or hook configs. The script checks CLI availability, socket connectivity, hook status, session stores, and settings paths.

Run the skill when an agent fails to restore after restart, notifications go silent, or browser automation breaks. It suggests a narrow fix—such as reinstalling a hook for a specific agent—instead of a full reset. After you apply the fix, the skill reruns diagnostics and shows what changed.

Read-only by default: never prints raw configs, prompt logs, or histories. Instead, reports file size, modified time, and marker presence.

What it helps with

  • Verify cmux sockets work and CLI is accessible
  • Find why an agent won't resume inside a cmux terminal
  • Confirm hooks are installed and enabled for the current agent
  • Diagnose broken cmux notifications
  • Collect a debug report for support without leaking sensitive data

Example prompts for the agent

  • Run cmux diagnostics and tell me what's broken
  • Check cmux health for this agent, include session context
  • Show me why notifications fail and how to fix it

How to install cmux-diagnostics

1Skills CLI (Vercel)

npx skills add manaflow-ai/cmux --skill cmux-diagnostics -a claude-code

2Manually: put the files in place

~/.claude/skills/cmux-diagnostics/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/cmux-diagnostics/

From the same set13

The whole set →
cmux manaflow-ai Skill for navigating multi-pane cmux layouts: create windows, workspaces, splits, focus surfaces, and move terminals and browser panels without breaking automation. Use it when an agent needs deterministic placement and routing. Claude Code CX Codex Cursor +1 9,600installs cmux-browser manaflow-ai Automates browser surfaces via the cmux CLI without stealing user focus. Useful for background page inspections, waiting on selectors, and form fills. Claude Code CX Codex Cursor +1 8,800installs cmux-customization manaflow-ai Configures the cmux workspace manager: edits cmux.json, wires Command Palette actions, sets dock terminals, and routes terminal-level styling directly to Ghostty. Claude Code CX Codex Cursor +1 6,600installs cmux-keyboard-shortcuts manaflow-ai Configures cmux shortcuts in ~/.config/cmux/cmux.json. Useful for adopting tmux-style chords, auditing overrides, and validating syntax. Claude Code CX Codex Cursor +1 6,200installs cmux-testing manaflow-ai Skill for choosing verification scopes, adding tests, and validating Swift test targets in the cmux project. Decides what local and CI evidence a change needs. Claude Code CX Codex Cursor +1 4,900installs cmux-custom-sidebar manaflow-ai Skill for writing a custom cmux sidebar in a SwiftUI-like language. The sidebar binds to workspaces, tabs, PRs, and clock; hot-reloads on save; runs cmux commands on tap. Claude Code CX Codex Cursor +1 4,800installs cmux-architecture manaflow-ai Guides modular Swift package architecture, strict 5-layer dependency inversion, and Swift 6 concurrency rules in the cmux codebase. Claude Code CX Codex Cursor +1 4,800installs cmux-ghostty manaflow-ai Enforces workflow guidelines for the Ghostty submodule and GhosttyKit compilation in cmux. Useful when syncing the fork or committing submodule pointers. Claude Code CX Codex Cursor +1 4,700installs

Similar

img2threejs img2threejs Builds a procedural Three.js model from an object or character image. Use it for code-based reconstruction, animation preparation, and staged model generation. Claude Code CX Codex Cursor +1 2,400installs surprise-me bytedance This skill combines available skills into one unexpected creative deliverable. Use it when you want inspiration or a project without choosing the format yourself. Claude Code CX Codex Cursor +1 2,300installs cloud-sync thedotmack Syncs your claude-mem database with cmem.ai Pro cloud storage. Checks sync status, manages the connection, and uploads observation narratives to the server. Claude Code CX Codex Cursor +1 2,100installs prioritization-frameworks phuryn Reference guide to 9 prioritization frameworks: RICE, ICE, Opportunity Score, Kano, MoSCoW and more. Helps you pick the right method, compare approaches, and rank tasks by importance. Claude Code CX Codex Cursor +1 9,900installs setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. Claude Code 1,052,851installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. Claude Code 711,230installs writing-plans Jesse Vincent This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks. Claude Code CX Codex 282,859installs caveman-review JuliusBrussee Turns code review comments into one line per finding: location, problem, fix. Useful when a diff or PR needs a fast pass without the filler. Claude Code CX Codex Cursor +1 410,700installs

Questions about cmux-diagnostics

How do I install cmux-diagnostics in Claude Code?

Run npx skills add manaflow-ai/cmux --skill cmux-diagnostics -a claude-code. The skill will be available at ~/.claude/skills/cmux-diagnostics/SKILL.md.

What does cmux-diagnostics do?

It checks cmux CLI and sockets, validates settings, tests hooks, and locates saved sessions. Output shows status, file sizes, and markers only—no raw configs or secrets.

When should I use the --include-context flag?

Only when workspace names, paths, or current cmux IDs are relevant to the issue. By default, the skill omits context for privacy.

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor