claw-mux

# cmux Core Control Use this skill to control cmux topology, terminal I/O (send commands to other panes and read output), notifications, and sidebar metadata. ## Environment Detection cmux sets `$CMUX_WORKSPACE_ID` and `$CMUX_SURFACE_ID` in every terminal it spawns. Check before using cmux commands: ```bash if [ -z "$CMUX_WORKSPACE_ID" ]; then echo "Not running inside cmux — cmux commands unavailable" fi ``` If not in cmux, fall back to standard tools (no pane splitting, no cmux notifications). ## Core Concepts - **Window**: Top-level macOS cmux window. - **Workspace**: Tab-like group within a window (sidebar entry). - **Pane**: Split container in a workspace. - **Surface**: A tab within a pane (terminal or browser panel). Hierarchy: Window > Workspace > Pane > Surface Default output uses short refs: `window:N`, `workspace:N`, `pane:N`, `surface:N`. UUIDs are still accepted as inputs. Request UUID output only when needed: `--id-format uuids|both`. ## Fast Start ### Topology ```bash # Always identify first — short refs (pane:1, surface:N) are session-scoped cmux identify --json # current caller context cmux list-workspaces # list workspaces cmux list-panes # list panes in workspace cmux list-pane-surfaces --pane pane:1 # list surfaces in pane cmux new-workspace # create ...