cmux

Source excerpt starting at line 1.

1# Panes and Surfaces2 3```bash4# inspect5cmux list-panes6cmux list-pane-surfaces --pane pane:17 8# create9cmux new-split right --panel pane:110cmux new-split down --command "npm run dev"11cmux new-pane --type terminal --direction right --command "tail -f logs/dev.log"12cmux new-surface --type terminal --pane pane:113cmux new-surface --type terminal --pane pane:1 --working-directory "$PWD" --command "npm test"14cmux new-surface --type browser --pane pane:1 --url https://example.com15 16# focus and close17cmux focus-pane --pane pane:218cmux focus-panel --panel surface:719cmux close-surface --surface surface:720 21# move and reorder22cmux move-surface --surface surface:7 --pane pane:2 --focus true23cmux move-surface --surface surface:7 --workspace workspace:2 --window window:1 --after surface:424cmux split-off --surface surface:7 right25cmux reorder-surface --surface surface:7 --before surface:326```27 28Surface identity is stable across move, reorder, and split-off. Layout commands are focus-neutral by default; pass `--focus true` only when the moved or created surface should be selected.29 30## Initial command31 32`--command <text>` on `new-split`, `new-pane`, `new-surface`, and `new-workspace` starts the new terminal's regular interactive shell and types the text plus one Enter into it at spawn time. Use it instead of create-then-`send`-then-`send-key enter` whenever the first command is known.33 34- The text is delivered literally; quoting, `&&`, pipes, and `$VARS` are interpreted by the new shell. `--command=<text>` also works, and a value is required.35- The shell stays alive after the command exits. This differs from the socket `initial_command` param, which replaces the shell with a one-shot process.36- Terminal-only: combining it with `--type browser`, `simulator`, or `agent-session` is an error. Blank or whitespace-only text is ignored. `new-workspace --layout` ignores it; layout surfaces define their own commands.37- Remote tmux mirrored workspaces reject it, so the request fails instead of silently dropping the command.38- Socket: the same behavior is the `initial_input` param on `surface.split`, `pane.create`, `surface.create`, and `workspace.create`. It is delivered raw, so append the Enter keystroke (`\r`) yourself.39