Free SKILL.md scraped from GitHub. Clone the repo or copy the file directly into your Claude Code skills directory.
npx versuz@latest install manaflow-ai-cmux-skills-cmux-debug-windowsgit clone https://github.com/manaflow-ai/cmux.gitcp cmux/SKILL.MD ~/.claude/skills/manaflow-ai-cmux-skills-cmux-debug-windows/SKILL.md---
name: cmux-debug-windows
description: 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.
---
# 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
1. Verify debug menu wiring in `Sources/cmuxApp.swift` under `CommandMenu("Debug")`.
- Menu path in app: `Debug` → `Debug Windows` → window entry.
- The `Debug` menu only exists in DEBUG builds (`./scripts/reload.sh --tag ...`).
- Release builds (`reloadp.sh`, `reloads.sh`) do not show this menu.
2. Keep these actions available in `Menu("Debug Windows")`:
- `Sidebar Debug…`
- `Background Debug…`
- `Menu Bar Extra Debug…`
- `Open All Debug Windows`
3. Reuse existing per-window copy buttons (`Copy Config`) in each debug window before adding new UI.
4. For one combined payload, run:
```bash
skills/cmux-debug-windows/scripts/debug_windows_snapshot.sh --copy
```
5. After code edits, run build + tagged reload:
```bash
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:
```bash
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
```