cmux-debug-windows

Original：🇺🇸 English
Translated
1 scripts

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.

2installs
Sourcemanaflow-ai/cmux
Added on

NPX Install

npx skill4agent add manaflow-ai/cmux cmux-debug-windows

Tags

Translated version includes tags in frontmatter
cmux-debugdebug-window-managementdebug-menu-configurationsnapshot-scriptxcode-build

SKILL.md Content

View Translation Comparison →

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
  1. Reuse existing per-window copy buttons (
    Copy Config
    ) in each debug window before adding new UI.
  2. For one combined payload, run:
bash
skills/cmux-debug-windows/scripts/debug_windows_snapshot.sh --copy
  1. 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