cmux-debug-windows

Assemble and export combined cmux debug window payloads to the clipboard.

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/Aradotso/ara.engineer --skill cmux-debug-windows-aradotso
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cmux-debug-windows
Source: https://github.com/Aradotso/ara.engineer/tree/main/skills/cmux-debug-windows
Command: npx skills add https://github.com/Aradotso/ara.engineer --skill cmux-debug-windows-aradotso

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires defaults, pbcopy, and includes scripts (resource) components.

What problem does it solve?

Manage cmux debug windows and their wiring for a consistent developer experience.

Core Features & Use Cases

  • Open, tune, and snapshot the Debug Windows entries for Sidebar Debug, Background Debug, and Menu Bar Extra Debug.
  • Verify Debug menu wiring in Sources/cmuxApp.swift and ensure consistent behavior between DEBUG and Release builds.
  • Generate and export a combined payload for debugging or collaboration.

Quick Start

Run the debug snapshot script to capture the current payload and optionally copy it to the clipboard.

Frequently Asked Questions about cmux-debug-windows

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

FAQPage Schema
How do I snapshot macOS debug windows configurations for cmux?

To snapshot cmux debug windows, run the debug snapshot script to read macOS defaults and assemble a combined payload for the Sidebar, Background, and Menu Bar Extra windows. The script optionally copies the final debug payload directly to the clipboard.

What is the best way to manage debug menu wiring across macOS debug builds?

Managing debug menu wiring involves verifying the connections in Sources/cmuxApp.swift to ensure consistent behavior between DEBUG and Release builds. This process keeps the debug windows properly configured and synchronized across different build environments.

How do I export a combined debug payload from macOS defaults to the clipboard?

You export a combined debug payload by running the provided script, which reads the necessary macOS defaults and aggregates them. The script then uses the pbcopy dependency to optionally copy the assembled debug payload directly to your clipboard.

Does the cmux debug windows snapshot script work with Release builds?

The debug windows snapshot script primarily targets debug builds, but it helps verify wiring in Sources/cmuxApp.swift to ensure consistent behavior between DEBUG and Release builds. This validation prevents configuration discrepancies across your build types.

Why are my cmux Sidebar and Background debug windows showing inconsistent configurations?

Inconsistent debug windows configurations occur when macOS defaults are not synchronized across debug builds. You can resolve this by running the snapshot script to assemble a unified payload and verifying the debug menu wiring in Sources/cmuxApp.swift.

Can I use this script to tune the Menu Bar Extra Debug window?

Yes, you can use the script to open and tune the Debug Windows entries for the Sidebar Debug, Background Debug, and Menu Bar Extra Debug. It reads the relevant macOS defaults to capture and adjust these specific window configurations.