← ClaudeAtlas

spawn-claude-workspacelisted

Spawn a new cmux workspace in the background, start a fresh Claude Code instance inside it, and auto-deliver a user-supplied prompt. Focus stays on the current workspace. Use when the user wants to kick off a parallel Claude task in a new workspace, branch a long-running job off into its own terminal, or dispatch a background prompt without losing their current context.
elitecoder/assistant · ★ 0 · AI & Automation · score 62
Install: claude install-skill elitecoder/assistant
# spawn-claude-workspace Spawn a new cmux workspace **in the background**, launch `claude` inside it, and auto-send the user's prompt. The new workspace is created unfocused — the user stays on their current tab. If they want to switch to the spawned workspace they do it themselves with `cmux select-workspace`. ## Prerequisites This skill assumes you've also loaded **`/cmux-workspace`**, which is cmux's own canonical reference for caller-targeting and non-disruptive automation. It owns these rules so this skill doesn't duplicate them: - Use `CMUX_WORKSPACE_ID` / `CMUX_SURFACE_ID` env vars (or `cmux identify --json .caller.*`) — never `.focused.*`. - Never call focus-changing verbs (`select-workspace`, `focus-pane`, `focus-window`) speculatively. - Pass `--focus false` whenever a verb supports it. This skill builds on top of `/cmux-workspace` and adds the Claude-Code-specific orchestration (write prompt → spawn workspace → wait for banner → submit by file reference → verify via JSONL transcript). ## Calibration notes (Claude-Code-specific, verified on this machine) The cmux team owns the `cmux` CLI's general behavior (see `/cmux` and `/cmux-workspace`). The notes below are the *Claude-Code-specific* gotchas you won't find in upstream cmux skills. **ALWAYS pass `--focus false` to `cmux new-workspace`.** Mukul's absolute rule (2026-05-23): the spawn never takes the user's foreground, even when they ask. If they want to switch they can run `cmux select-workspace` themselv