skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
manaflow-ai/cmux604 installs

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-windows
view source ↗

Is 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

  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

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>