Pane and Surface Control with cmux

Use this skill for workspace-internal topology changes: splits, panes, surfaces, tabs, and resume metadata.

Default to the caller workspace and caller surface from CMUX_WORKSPACE_ID and CMUX_SURFACE_ID. For workspace-scoping rules and non-disruptive automation, read ../cmux-workspace/SKILL.md.

Core Workflow

1. Inspect the current workspace topology.
2. Create the pane or surface additively.
3. Move or reorder only when creation-time placement is not enough.
4. Use tab actions for rename/pin/duplicate/close flows.
5. Store a resume command on long-lived terminals when the user wants reopen/restore support.

cmux identify --json
cmux list-panes --workspace "${CMUX_WORKSPACE_ID:-}" --json
cmux list-pane-surfaces --workspace "${CMUX_WORKSPACE_ID:-}" --json