references/windows-workspaces.md
391 tokens · o200k_base · 1,520 bytes
Source excerpt starting at line 1.# Windows and Workspaces ```bash# inspectcmux list-windowscmux current-windowcmux list-workspacescmux current-workspace # lifecyclecmux new-windowcmux focus-window --window window:2cmux close-window --window window:2cmux new-workspacecmux select-workspace --workspace workspace:4cmux close-workspace --workspace workspace:4 # reorder and movecmux reorder-workspace --workspace workspace:4 --before workspace:2cmux move-workspace-to-window --workspace workspace:4 --window window:1``` ## Context-Menu Actions `cmux workspace-action` runs the workspace right-click actions (color, description, rename, pin, read state, ordering). Defaults to the caller's workspace; override with `--workspace <id|ref|index>`. ```bashcmux workspace-action --action set-color --color Blue # name or #RRGGBB hexcmux workspace-action --action set-description --description "Ship checklist"cmux workspace-action --action rename --title "infra"cmux workspace-action --action pincmux workspace-action --action clear-color``` Other actions: `unpin`, `clear-name`, `clear-description`, `mark-read`/`mark-unread`, `move-up`/`move-down`/`move-top`, `close-others`/`close-above`/`close-below`. Named colors: Red, Crimson, Orange, Amber, Olive, Green, Teal, Aqua, Blue, Navy, Indigo, Purple, Magenta, Rose, Brown, Charcoal. `set-color` tints a single workspace (stored as workspace state); the `workspaceColors` block in `cmux.json` defines the shared palette and selection/badge colors, not per-workspace assignments.