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…

INSTALLATION
npx skills add https://github.com/manaflow-ai/cmux --skill cmux-debug-windows
Run in your project or agent environment. Adjust flags if your CLI version differs.

SKILL.md

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.swift under CommandMenu("Debug").
  • Menu path in app: DebugDebug 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.
  • 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
BrowserAct

Let your agent run on any real-world website

Bypass CAPTCHA & anti-bot for free. Start local, scale to cloud.

Explore BrowserAct Skills →

Stop writing automation&scrapers

Install the CLI. Run your first Skill in 30 seconds. Scale when you're ready.

Start free
free · no credit card