| name | cmux-tab-command |
| description | Open a new cmux terminal tab/surface and run a shell command there. Use when the user asks to run, trigger, or execute a command in a new cmux tab, especially in a dev cmux build where the active CLI/socket must be respected. |
| allowed-tools | Bash(cmux:*), Bash(scripts/open-tab-run.sh:*) |
cmux Tab Command
Open a new cmux terminal surface in the current workspace/pane and execute the command the user provided.
Workflow
- Confirm the active CLI/socket when the user is worried about dev vs release targeting:
which cmux
cmux version
cmux identify --no-caller
- Prefer the bundled helper so parsing and paste behavior stay consistent:
scripts/open-tab-run.sh -- <command>
- For commands with shell operators, quote the full command:
scripts/open-tab-run.sh -- "pnpm test -- --runInBand"
scripts/open-tab-run.sh -- "printf 'hello '; date; pwd"
- If no command arguments are passed, the helper reads the command from stdin:
printf '%s\n' 'npm run dev' | scripts/open-tab-run.sh
Notes
- The helper uses whichever
cmux is first on PATH, unless CMUX_BIN is set.
- It preserves the active cmux socket via the environment, so dev/debug builds keep targeting their matching socket.
cmux new-surface prints status text such as OK surface:5 pane:2 workspace:1; parse out surface:n before sending commands.- After triggering, use
cmux read-screen --surface <surface:n> --lines <n> when proof is needed.
