Skip to content
LiveNew tools this week
Submit
AIMarketly
cmux-diagnostics logo

cmux Diagnostics

cmux-diagnostics

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.

manaflow-ai/cmux6.2Kinstalls27.6Kstars

SKILL.md

Full skill instructions

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:

# 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:

skills/​cmux-diagnostics/​scripts/​cmux-diagnostics --include-context

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:

    ~/​.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:

    cmux hooks setup --agent codex
cmux hooks setup --agent opencode
cmux hooks setup

    Only run install or uninstall commands after the user agrees. cmux hooks setup installs supported agents found on PATH and skips missing agents.

  4. Session restore evidence:

    ls -lh ~/​.cmuxterm/​*-hook-sessions.json 2>/​dev/​null

    Missing session stores usually means the agent has not run inside cmux since hooks were installed, hooks are disabled, or the agent integration does not support resume capture.

  5. Notification path:

    cmux notify "cmux diagnostic test"

    Use this only when the user is ready for a visible test notification.

Interpretation

  • cmux not found: the CLI is not installed or not on PATH for this shell.
  • cmux ping fails: app is not reachable through the current socket path, the app is closed, or automation access is disabled.
  • No CMUX_WORKSPACE_ID or CMUX_SURFACE_ID: the command is probably running outside a cmux terminal. Some hooks intentionally no-op outside cmux.
  • Hook config exists but no session store: run one supported agent inside cmux after installing hooks, then re-check.
  • Session store exists but restore does not launch agents: check terminal.autoResumeAgentSessions and whether the saved executable still exists on PATH.
  • Settings validation fails: fix the config first. Invalid config can make later symptoms misleading.

Rules

  • Stay read-only until the user asks to fix something.
  • Never print raw hook files, session JSON, prompt logs, shell history, tokens, or API keys.
  • Summarize file presence, size, modified time, and marker presence instead of contents.
  • Prefer narrow fixes such as cmux hooks setup --agent codex over reinstalling every integration.
  • After a fix, rerun the diagnostic script and report the changed lines.

More skills from manaflow-ai

cmux-keyboard-shortcuts logo
manaflow-ai/cmux

cmux-keyboard-shortcuts

Guide and apply cmux keyboard shortcut customization. Use when the user asks to customize, rebind, unbind, reset, audit, or create shortcut templates for cmux, including tmux-style, Vim-style, terminal-first, browser-heavy, iTerm/Terminal-like, or agent-triage layouts.

27.6K 5.9K
View
cmux-testing logo
manaflow-ai/cmux

cmux-testing

cmux testing rules for Swift Testing, test target compilation, test wiring, and package/refactor validation. Use when adding or changing tests, touching package/refactor code, or deciding whether reload.sh is enough validation.

27.6K 4.7K
View
cmux-dev-workflow logo
manaflow-ai/cmux

cmux-dev-workflow

Contributor workflow rules for cmux setup, Xcode project normalization, tagged sidebar ExtensionKit development, and dev builds. Use when setting up the cmux repo, changing Xcode project files, adding sidebar extensions, or working with tagged debug builds.

27.6K 4.7K
View
cmux-architecture logo
manaflow-ai/cmux

cmux-architecture

cmux package architecture, refactor layering, dependency inversion, file organization, DocC documentation, package design discipline, testability, and Swift 6 concurrency rules. Use before adding or meaningfully rewriting Swift files, Swift packages, coordinators, services, repositories, or public package APIs.

27.6K 4.6K
View
cmux-debugging logo
manaflow-ai/cmux

cmux-debugging

Debug logging, Debug menu, runtime pitfalls, typing-latency-sensitive paths, SwiftUI list snapshot boundaries, OS-version repros, and local visual iteration for cmux. Use when adding debug probes, diagnosing UI/runtime issues, touching terminal rendering, tab/sidebar list views, drag/drop UTTypes, or using the Debug menu.

27.6K 4.5K
View
cmux-custom-sidebar logo
manaflow-ai/cmux

cmux-custom-sidebar

Build a custom cmux sidebar from a plain-language request. Use when the user asks for a custom sidebar, a sidebar that shows their workspaces/tabs/PRs/clock, a vibe-coded sidebar, or anything involving files in ~/.config/cmux/sidebars/. Covers authoring the interpreted SwiftUI-style file, enabling the beta flag, selecting it, and iterating with hot reload.

27.6K 4.5K
View
cmux-backend logo
manaflow-ai/cmux

cmux-backend

Backend TypeScript and Cloud VM development rules for cmux. Use when editing web/app/api, web/services, backend scripts, Cloud VM lifecycle, provider integrations, Postgres, Stack Auth pricing gates, migrations, or provider image build scripts.

27.6K 4.5K
View
cmux-localization logo
manaflow-ai/cmux

cmux-localization

Localization rules and audit workflow for cmux UI strings, settings rows, menus, shortcuts, schema/config text, docs, command/help text, alerts, tooltips, and web messages. Use whenever changing user-facing text.

27.6K 4.5K
View
cmux-socket-policy logo
manaflow-ai/cmux

cmux-socket-policy

Socket command threading and focus policy for cmux CLI/socket work. Use when adding or changing socket commands, CLI commands, telemetry commands, focus/select/open/close/send-key behavior, or automation that could steal app focus.

27.6K 4.5K
View
cmux-ghostty logo
manaflow-ai/cmux

cmux-ghostty

Ghostty submodule and GhosttyKit workflow rules for cmux. Use when modifying the ghostty submodule, rebuilding GhosttyKit.xcframework, updating the parent submodule pointer, or documenting fork conflict notes.

27.6K 4.5K
View

Popular AI tools

View all
Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View
IMGCreator.ai logo
Images

IMGCreator.ai

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View
Clipdrop Uncrop logo
Images

Clipdrop Uncrop

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C
Finance

ChainClarity

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View