cmux-debug-windows
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.
How do I install this agent skill?
npx skills add https://github.com/manaflow-ai/cmux --skill cmux-debug-windowsIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill manages local app debugging and builds. It contains a script that reads macOS application preferences, which could be directed to read data from other applications if an arbitrary domain is provided.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
3/3 files flagged
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
cmux Debug Windows
Keep this workflow focused on existing debug windows and menu entries. Do not add a new utility/debug control window unless the user asks explicitly.
Workflow
- Verify debug menu wiring in
Sources/cmuxApp.swiftunderCommandMenu("Debug").- Menu path in app:
Debug→Debug Windows→ window entry. - The
Debugmenu only exists in DEBUG builds (./scripts/reload.sh --tag ...). - Release builds (
reloadp.sh,reloads.sh) do not show this menu.
- Menu path in app:
- Keep these actions available in
Menu("Debug Windows"):
Sidebar Debug…Background Debug…Menu Bar Extra Debug…Open All Debug Windows
- Reuse existing per-window copy buttons (
Copy Config) in each debug window before adding new UI. - For one combined payload, run:
skills/cmux-debug-windows/scripts/debug_windows_snapshot.sh --copy
- After code edits, run build + tagged reload:
xcodebuild -project GhosttyTabs.xcodeproj -scheme cmux -configuration Debug -destination 'platform=macOS' build
./scripts/reload.sh --tag <tag>
Key Files
Sources/cmuxApp.swift: Debug menu entries and debug window controllers/views.Sources/AppDelegate.swift: Menu bar extra debug settings payload and defaults keys.
Script
scripts/debug_windows_snapshot.sh
Purpose:
- Reads current debug-related defaults values.
- Prints one combined snapshot for sidebar/background/menu bar extra.
- Optionally copies it to clipboard.
Examples:
skills/cmux-debug-windows/scripts/debug_windows_snapshot.sh
skills/cmux-debug-windows/scripts/debug_windows_snapshot.sh --copy
skills/cmux-debug-windows/scripts/debug_windows_snapshot.sh --domain <bundle-id> --copy
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/manaflow-ai/cmux/cmux-debug-windows">View cmux-debug-windows on skillZs</a>