cmux-diagnostics

Generate read-only cmux health reports without exposing sensitive data.

25.8k|2.2k|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/manaflow-ai/cmux --skill cmux-diagnostics-manaflow-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cmux-diagnostics
Source: https://github.com/manaflow-ai/cmux/tree/main/skills/cmux-diagnostics
Command: npx skills add https://github.com/manaflow-ai/cmux --skill cmux-diagnostics-manaflow-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill collects and interprets support-safe cmux diagnostics for end users, defaulting to read-only checks and never exposing sensitive hook contents, session stores, prompts, tokens, or environment secrets.

Core Features & Use Cases

  • Read-only health report: checks hooks, sessions, settings, CLI readiness, and socket status.
  • Quick remediation guidance: provides safe, actionable steps to address common cmux issues.
  • Use Case: When a user reports cmux not functioning or hooks or sessions failing, run diagnostics to surface health indicators and recommended next steps.

Quick Start

Run the cmux-diagnostics script to generate a read-only health report for the current checkout or installed skill.

Frequently Asked Questions about cmux-diagnostics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a health check on cmux when hooks or sessions are failing?▼

Run the cmux diagnostics script to generate a read-only health report that checks hooks, sessions, CLI readiness, and socket status, while providing actionable remediation steps for identified issues.

What does a safe cmux diagnostic report include?▼

A safe cmux diagnostic report includes health status for hooks, sessions, settings, and CLI operations, while intentionally omitting sensitive hook contents, session stores, prompts, tokens, or environment secrets.

Can I debug cmux CLI operations without exposing sensitive environment secrets?▼

Yes, you can safely debug cmux CLI operations using read-only diagnostics, which surface health indicators and configuration status without exposing sensitive hook contents, prompts, tokens, or environment secrets.

Why does my cmux configuration fail to load properly?▼

Your cmux configuration may fail due to issues with hooks, sessions, or socket status, which you can identify by running a read-only diagnostics script to surface health indicators and specific remediation steps.

What should I do when cmux is not functioning and I need a doctor report?▼

When cmux is not functioning, execute the diagnostics script to generate a doctor report that surfaces health indicators across components and provides safe, actionable guidance to address common issues.

Does the cmux diagnostics script require write permissions to troubleshoot issues?▼

No, the cmux diagnostics script requires only read-only permissions to troubleshoot issues, checking health and configuration status of components without modifying settings or exposing sensitive data.