Skills
.Work. You
Rest

cmux-diagnostics

Community

Get a support-safe cmux health report

Software Engineering#hooks#diagnostics#cmux#session restore#settings validation#support debug#socket health
Authordeerawan
Version1.0.0
Installs0

System Documentation

What problem does it solve?

cmux-diagnostics helps troubleshoot when cmux hooks, notifications, session restore, settings, browser automation, socket access, CLI control, or agent resume behavior is not working by producing a read-only, support-safe diagnostics report.

Core Features & Use Cases

  • Read-only cmux health checks: Verifies cmux CLI availability, connectivity (ping), and capabilities without dumping sensitive content.
  • Settings validation and auto-resume checks: Checks current cmux settings and the value of terminal.autoResumeAgentSessions to explain session restore outcomes.
  • Hook and session store evidence review: Summarizes whether expected hook configs exist and whether *-hook-sessions.json stores are present (without printing raw JSON contents).
  • Agent binary presence audit: Confirms which supported agent executables are available on PATH to explain hook setup gaps.

Quick Start

Run the bundled read-only script to generate a health report: ~/.agents/skills/cmux-diagnostics/scripts/cmux-diagnostics --include-context

Dependency Matrix

Required Modules

None required

Components

scripts

đź’» Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: cmux-diagnostics
Download link: https://github.com/deerawan/dotfiles/archive/main.zip#cmux-diagnostics

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.