cmux-debug-windows

Tune and snapshot cmux debug windows for macOS app menus.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/ever-oli/omni-ecosystem --skill cmux-debug-windows
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cmux-debug-windows
Source: https://github.com/ever-oli/omni-ecosystem/tree/main/omni-desktop/skills/cmux-debug-windows
Command: npx skills add https://github.com/ever-oli/omni-ecosystem --skill cmux-debug-windows

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Manage cmux debug windows and related debug menu wiring for Sidebar Debug, Background Debug, and Menu Bar Extra Debug. Use this when the user asks to open/tune these debug controls, add or adjust Debug menu entries, or capture/copy a combined debug config snapshot.

Core Features & Use Cases

  • Keep debug menu wiring in Sources/cmuxApp.swift under CommandMenu("Debug").
  • Debug Windows entries exposed in the Debug menu, usable for Sidebar Debug, Background Debug, and Menu Bar Extra Debug.
  • Reuse existing per-window Copy Config buttons and support a single combined payload snapshot via the snapshot script.
  • After edits, generate the snapshot with script skills/cmux-debug-windows/scripts/debug_windows_snapshot.sh --copy.

Quick Start

Run the combined snapshot script to collect and copy the current cmux debug 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 snapshot cmux debug windows configurations for macOS apps?

To snapshot cmux debug windows, run the debug_windows_snapshot.sh script with the --copy flag to collect and copy the current combined debug payload. This automates capturing Sidebar, Background, and Menu Bar Extra debug configurations.

What is the best way to manage debug menu wiring for Sidebar, Background, and Menu Bar Extra in macOS apps?

Managing debug menu wiring involves keeping configurations under CommandMenu("Debug") in cmuxApp.swift. This structure exposes per-window controls to tune Sidebar, Background, and Menu Bar Extra debug sessions.

How do I add or adjust Debug menu entries for cmux windows?

Adjust Debug menu entries by editing the wiring in Sources/cmuxApp.swift under CommandMenu("Debug"). This allows developers to tune and expose controls for Sidebar, Background, and Menu Bar Extra debug windows.

Can I capture a combined payload snapshot of all cmux debug windows at once?

Yes, you can capture a combined payload snapshot by running the debug_windows_snapshot.sh script with the --copy flag. This collects configurations from all debug windows into a single portable payload.

Does the cmux debug windows snapshot script require specific macOS defaults domain data to be read?

Yes, the snapshot script requires analyzing the debug_windows_snapshot.sh script and ensuring the macOS defaults domain data can be read successfully to generate an accurate combined payload snapshot.