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.