cmuxlisted
Install: claude install-skill Samuelca6399/AbsolutelySkilled
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