cmux-debug-windows

Tune cmux debug window wiring and generate combined payload snapshots.

Updated Mar 21, 2026
One-click install
npx skills add https://github.com/Derek-X-Wang/skills --skill cmux-debug-windows-derek-x-wang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cmux-debug-windows
Source: https://github.com/Derek-X-Wang/skills/tree/main/cmux-debug-windows
Command: npx skills add https://github.com/Derek-X-Wang/skills --skill cmux-debug-windows-derek-x-wang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Manage cmux debug windows and wiring for Sidebar Debug, Background Debug, and Menu Bar Extra Debug to streamline debugging workflows and ensure consistent UI controls across builds.

Core Features & Use Cases

  • Verify and maintain Debug menu wiring in the app (Sources/cmuxApp.swift) and ensure per-window controls are available in Debug builds.
  • Preserve and reuse Copy Config actions within each debug window and generate a single, combined payload snapshot.
  • Provide a reusable script to snapshot defaults and payload for sharing and debugging (scripts/debug_windows_snapshot.sh).
  • After edits, run the required build and reload steps to apply changes.

Quick Start

Open the cmux Debug Windows panel and run the script skills/cmux-debug-windows/scripts/debug_windows_snapshot.sh to capture and copy the combined payload.

Frequently Asked Questions about cmux-debug-windows

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

FAQPage Schema
How do I stabilize cmux debug windows across different builds?

You can stabilize cmux debug windows across builds by tuning the app wiring in Sources/cmuxApp.swift and ensuring per-window UI controls are consistently available in Debug builds.

How do I generate a combined payload snapshot for cmux debugging?

You generate a combined payload snapshot by running the scripts/debug_windows_snapshot.sh script to capture and copy the defaults-driven payload for sharing and debugging.

What is the best way to manage wiring for Sidebar Debug and Background Debug?

The best way to manage wiring for Sidebar Debug and Background Debug is to verify and maintain the Debug menu wiring in the app and preserve Copy Config actions within each debug window.

Do I need to run build and reload steps after editing cmux debug windows?

Yes, you need to run the required build and reload steps after editing cmux debug windows to apply changes and ensure consistent debug window behavior across builds.

Can I reuse Copy Config actions within each cmux debug window?

Yes, you can preserve and reuse Copy Config actions within each cmux debug window to streamline debugging workflows and maintain consistent UI controls across builds.

Why are my cmux debug window controls inconsistent across builds?

Your cmux debug window controls may be inconsistent because the app wiring in Sources/cmuxApp.swift needs tuning to ensure per-window controls are properly available in Debug builds.