cmux

When this skill is activated, always start your first response with the 🧢 emoji. # cmux cmux is a terminal multiplexer controlled via a Unix socket CLI. It manages windows, workspaces, panes, and surfaces. AI agents use it to spawn isolated terminal panes for parallel tasks, send commands, read output, and clean up when done. All commands use `cmux [--json] <command> [options]`. Always pass `--json` when parsing output programmatically. References use short refs like `pane:5`, `surface:12`, `workspace:3` - or UUIDs. --- ## When to use this skill Trigger this skill when the user or agent needs to: - Spawn split panes for sub-agent tasks or parallel work - Send commands or keystrokes to a specific terminal surface - Read screen content from a pane/surface - Create, list, close, or manage workspaces - Open browser surfaces alongside terminal panes - Orchestrate multi-pane layouts for subagent-driven development - Rename, reorder, or move surfaces/panes between workspaces Do NOT trigger this skill for: - General shell scripting unrelated to cmux - tmux or screen commands (cmux has its own protocol) --- ## Environment variables cmux auto-sets these in every terminal it creates: | Variable | Purpose | |---|---| | `CMUX_WORKSPACE_ID` | Default `--workspace` for all commands | | `CMUX_SURFACE_ID` | Default `--surface` for commands | | `CMUX_TAB_ID` | Default `--tab` for tab-action/rename-tab | | `CMUX_SOCKET_PATH` | Override socket path (default: `/tmp/cmux.sock`) | Thes...