Help us improve
Share bugs, ideas, or general feedback.
From claw-mux
Controls cmux terminal topology (windows, workspaces, panes, surfaces), sends notifications, and updates sidebar metadata. Useful for automation needing deterministic placement, progress reporting, or navigation in multi-pane cmux layouts.
npx claudepluginhub leejuoh/claude-code-zero --plugin claw-muxHow this skill is triggered — by the user, by Claude, or both
Slash command
/claw-mux:claw-muxThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Use this skill to control cmux topology, routing, notifications, and sidebar metadata.
Controls cmux macOS terminal multiplexer: manages workspaces/panes/surfaces/panels, sends commands to terminals/browsers, automates browsers, notifications, sidebar metadata. Use on /cmux or cmux requests.
Orchestrates multi-pane terminals with cmux CLI: splits panes/workspaces, spawns Claude/Codex sub-agents, sends keys (incl. ctrl-c), reads output, updates sidebar, manages browser/markdown panes.
Controls cmux tabs, workspaces, and terminal panes via Unix socket. Use for reading terminal output, sending commands to another agent's pane, switching tabs, or monitoring coder progress.
Share bugs, ideas, or general feedback.
Use this skill to control cmux topology, routing, notifications, and sidebar metadata.
cmux sets $CMUX_WORKSPACE_ID and $CMUX_SURFACE_ID in every terminal it spawns. Check before using cmux commands:
if [ -z "$CMUX_WORKSPACE_ID" ]; then
echo "Not running inside cmux — cmux commands unavailable"
fi
If not in cmux, fall back to standard tools (no pane splitting, no cmux notifications).
Hierarchy: Window > Workspace > Pane > Surface
Default output uses short refs: window:N, workspace:N, pane:N, surface:N. UUIDs are still accepted as inputs. Request UUID output only when needed: --id-format uuids|both.
# identify current caller context
cmux identify --json
# list topology
cmux list-windows
cmux list-workspaces
cmux list-panes
cmux list-pane-surfaces --pane pane:1
# create / focus / move
cmux new-workspace
cmux new-split right --panel pane:1
cmux move-surface --surface surface:7 --pane pane:2 --focus true
cmux reorder-surface --surface surface:7 --before surface:3
# attention cue
cmux trigger-flash --surface surface:7
# simple notification (appears in sidebar + desktop alert)
cmux notify --title "Build Complete" --body "All tests passed"
# with subtitle
cmux notify --title "Claude Code" --subtitle "Waiting" --body "Agent needs input"
Update the sidebar status pills and progress bar for the current workspace:
# status pill: set-status <key> <value> [--icon icon] [--color #hex]
cmux set-status build "Ready" --icon checkmark --color green
cmux set-status build "Failed" --icon xmark --color red
cmux clear-status build
# progress bar (0.0 to 1.0, optional --label)
cmux set-progress 0.75 --label "Running tests"
# log messages (leveled, optional --source)
cmux log --level info --source claude-code "Starting build..."
cmux log --level success "Build complete"
cmux log --level warning "3 deprecation warnings"
cmux log --level error "Test suite failed"
cmux new-split for panes, cmux notify for notifications, cmux set-progress for progress.cmux-browser skill for embedded webview automation./cmux-markdown for the full command reference, or use cmux markdown open <path> directly.cmux claude-teams: Teams uses its own tmux-shim layer for topology — do not mix direct cmux topology commands with Teams orchestration.$CMUX_WORKSPACE_ID before using any cmux command.surface:7) are session-scoped and may change between sessions — always cmux identify --json at the start of automation to discover current topology.set-status requires a key (e.g., build) as the first argument — the key allows multiple independent status pills per workspace.cmux claude-teams is active, it manages topology through a tmux-compat shim. Direct topology commands (new-split, move-surface) may conflict with Teams orchestration.cmux log for always-visible status updates.| Reference | When to Use |
|---|---|
| Handles and Identify | Handle syntax, self-identify, caller targeting |
| Windows and Workspaces | Window/workspace lifecycle and reorder/move |
| Panes and Surfaces | Splits, surfaces, move/reorder, focus routing |
| Trigger Flash and Health | Visual flash confirmation and surface health checks |
| Notifications | Notification CLI, sidebar metadata API, hook patterns |