explainx.ainewsletter3.02k
Productivity

cmux-debug-windows▌

manaflow-ai/cmux · updated Apr 8, 2026

$npx skills add https://github.com/manaflow-ai/cmux --skill cmux-debug-windows
0 commentsdiscussion
summary

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.

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

  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:
skills/cmux-debug-windows/scripts/debug_windows_snapshot.sh --copy
  1. 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

Discussion

Product Hunt–style comments (not star reviews)
  • No comments yet — start the thread.
general reviews

Ratings

4.6★★★★★64 reviews
  • ★★★★★Pratham Ware· Dec 28, 2024

    We added cmux-debug-windows from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

  • ★★★★★Alexander Chawla· Dec 16, 2024

    cmux-debug-windows fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.

  • ★★★★★Henry Smith· Dec 16, 2024

    Registry listing for cmux-debug-windows matched our evaluation — installs cleanly and behaves as described in the markdown.

  • ★★★★★Min Park· Dec 12, 2024

    cmux-debug-windows fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.

  • ★★★★★Hana Srinivasan· Dec 4, 2024

    We added cmux-debug-windows from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

  • ★★★★★Advait Smith· Nov 23, 2024

    cmux-debug-windows fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.

  • ★★★★★Yash Thakker· Nov 19, 2024

    cmux-debug-windows fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.

  • ★★★★★Nia Ndlovu· Nov 7, 2024

    We added cmux-debug-windows from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

  • ★★★★★Min Gonzalez· Nov 7, 2024

    Solid pick for teams standardizing on skills: cmux-debug-windows is focused, and the summary matches what you get after install.

  • ★★★★★Min Wang· Nov 3, 2024

    We added cmux-debug-windows from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

showing 1-10 of 64

1 / 7