cmux-debugging

Diagnose cmux UI and runtime issues by collecting and interpreting debug logs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

cmux debugging instrumentation helps developers identify and diagnose UI and runtime issues by providing structured debug logs and a guided path for diagnosing pitfalls.

Core Features & Use Cases

  • Debug event logging for focus/panels, tabs, and panes
  • Access to a Debug menu in DEBUG builds for visual iteration and tuning
  • Reference guidance on runtime pitfalls to avoid common issues in rendering and input handling

Quick Start

Enable DEBUG probes in a cmux session and tail the generated log to observe focus and tab events.

Frequently Asked Questions about cmux-debugging

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

FAQPage Schema
How do I debug SwiftUI layout and event handling issues in cmux?

Debug SwiftUI layout and event handling issues in cmux by enabling DEBUG probes to collect structured logs for focus, tabs, and panes, then tail the generated log to observe runtime behavior.

What is the best way to diagnose runtime pitfalls during cmux feature development?

The best way to diagnose runtime pitfalls during cmux development is to use in-repo reference guidance alongside structured debug logs, which helps identify and avoid common rendering and input handling problems.

Do I need a DEBUG build to access the cmux Debug menu?

Yes, you need a DEBUG build to access the cmux Debug menu. Debug menu access and guarded instrumentation using #if DEBUG blocks are required to iterate visually and tune features safely.

How do I instrument drag and drop UTTypes in cmux for troubleshooting?

Instrument drag and drop UTTypes in cmux for troubleshooting by adding guarded debug event logging within #if DEBUG blocks, allowing you to trace event handling and latency without affecting production builds.

Why are my cmux tab and sidebar rendering events not logging correctly?

Tab and sidebar rendering events fail to log correctly when debug instrumentation is missing or not wrapped in #if DEBUG guards. Ensure your DEBUG build has the necessary probes enabled to capture the logs.

Can I use cmux debug logging to monitor focus and panel latency?

Yes, you can use cmux debug logging to monitor focus and panel latency. Enabling DEBUG probes captures structured event logs for focus and panels, helping you diagnose latency and event handling issues.