Agent skill

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.

View SKILL.md on GitHub Repository
Stars 13,747
Forks 1,003

Install this agent skill to your Project

npx add-skill https://github.com/manaflow-ai/cmux/tree/main/skills/cmux-debug-windows

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:
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

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

manaflow-ai/cmux

release

Prepare and ship a cmux release end-to-end: choose the next version, curate user-facing changelog entries, bump versions, open and monitor a release PR, merge, tag, and verify published artifacts. Use when asked to cut, prepare, publish, or tag a new release.

13,747 1,003
Explore
manaflow-ai/cmux

cmux-markdown

Open markdown files in a formatted viewer panel with live reload. Use when you need to display plans, documentation, or notes alongside the terminal with rich rendering (headings, code blocks, tables, lists).

13,747 1,003
Explore
manaflow-ai/cmux

cmux

End-user control of cmux topology and routing (windows, workspaces, panes/surfaces, focus, moves, reorder, identify, trigger flash). Use when automation needs deterministic placement and navigation in a multi-pane cmux layout.

13,747 1,003
Explore
manaflow-ai/cmux

cmux-browser

End-user browser automation with cmux. Use when you need to open sites, interact with pages, wait for state changes, and extract data from cmux browser surfaces.

13,747 1,003
Explore
davila7/claude-code-templates

verl-rl-training

Provides guidance for training LLMs with reinforcement learning using verl (Volcano Engine RL). Use when implementing RLHF, GRPO, PPO, or other RL algorithms for LLM post-training at scale with flexible infrastructure backends.

23,776 2,298
Explore
davila7/claude-code-templates

openrlhf-training

High-performance RLHF framework with Ray+vLLM acceleration. Use for PPO, GRPO, RLOO, DPO training of large models (7B-70B+). Built on Ray, vLLM, ZeRO-3. 2× faster than DeepSpeedChat with distributed architecture and GPU resource sharing.

23,776 2,298
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results