cmux-workspace
cmux workspace
What it does
- select-workspace switches the visible sidebar tab.
- focus-pane / focus-panel yanks pane or surface focus.
- tab-action with focus-changing actions.
- If the caller workspace already has a non-caller helper pane, add a new surface to that pane instead of creating another pane:
- If there is no helper pane, create exactly one right-side pane:
- Send commands to the new or reused helper surface by explicit surface ref. Do not focus it unless the user asks.
- Window: a macOS cmux window.
Requirements & configuration
- Use --id-format both when logs or handoffs need stable UUIDs plus human refs:
- Never build or launch untagged cmux DEV. If tests or tools need a socket, use the tag-specific socket:
Configuration: CMUX_WORKSPACE_IDCMUX_SURFACE_IDERRORCMUX_SOCKET_PATH
Derived from the skill's own SKILL.md documentation · extracted 2026-07-23
cmux-workspace FAQ
What does the cmux-workspace skill do?
Work inside the current cmux workspace and terminal. Use for cmux workspace, current workspace, caller surface, panes, surfaces, socket targeting, and non-interfering cmux automation. select-workspace switches the visible sidebar tab. focus-pane / focus-panel yanks pane or surface focus.
What does cmux-workspace require?
Use --id-format both when logs or handoffs need stable UUIDs plus human refs: Never build or launch untagged cmux DEV. If tests or tools need a socket, use the tag-specific socket: Configuration keys: CMUX_WORKSPACE_ID, CMUX_SURFACE_ID, ERROR, CMUX_SOCKET_PATH.
How do I install cmux-workspace?
Run: npx -y skills add https://github.com/manaflow-ai/cmux --skill cmux-workspace --agent claude-code — the source lives at github.com/manaflow-ai/cmux.
Maintain cmux-workspace?
Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.
[cmux-workspace on getagentictools](https://getagentictools.com/skills/manaflow-ai-cmux-cmux-workspace?ref=badge) npx agentictools info skills/manaflow-ai-cmux-cmux-workspace The second line is the CLI lookup for this page — handy in READMEs and docs.
