← ClaudeAtlas

cmux-workspacelisted

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.
manaflow-ai/cmux · ★ 20,069 · Web & Frontend · score 79
Install: claude install-skill manaflow-ai/cmux
# cmux Workspace Use this skill when a task should be scoped to the cmux workspace that invoked the agent. A workspace is the sidebar tab-like unit in cmux. It contains split panes, and each pane contains one or more surfaces. A surface is the terminal or browser session the user interacts with. ## Default Rule Scope actions to the current caller workspace unless the user explicitly asks for another workspace, another window, or global state. Do not assume the visually focused cmux workspace is the right target. An agent can be running in one workspace while the user is looking at another. Prefer the caller environment first: ```bash printf 'workspace=%s\nsurface=%s\nsocket=%s\n' \ "${CMUX_WORKSPACE_ID:-}" \ "${CMUX_SURFACE_ID:-}" \ "${CMUX_SOCKET_PATH:-}" cmux identify --json ``` Use `CMUX_WORKSPACE_ID` as the default workspace anchor and `CMUX_SURFACE_ID` as the default caller terminal/surface anchor. If those are missing, use `cmux identify --json` and be explicit that you are using the currently focused cmux context. ## Non-Disruptive Automation The user may be visually focused on a different workspace, window, or app while an agent works in the caller workspace. Treat layout and focus as separate concerns. Never call focus-changing verbs speculatively. Never call these without an explicit user ask: - `select-workspace` switches the visible sidebar tab. - `focus-pane` / `focus-panel` yanks pane or surface focus. - `tab-action` with focus-changing actions.