Bg It

bg-it — Spawn a Background Claude Session

Claude Code only. This skill uses claude --bg. Not available in Codex, Gemini CLI, or other environments — if running outside Claude Code, tell the user and stop.

Spawns a named background claude session for any prompt — all archetypes supported, including subagent-driven-development, interactive, inline, and custom.

Flow

digraph bg_it {
    "Know prompt path?" [shape=diamond];
    "Know skill prefix (if any)?" [shape=diamond];
    "Know session name?" [shape=diamond];
    "Ask human for missing info" [shape=box];
    "Build & show command" [shape=box];
    "User confirms?" [shape=diamond];
    "Spawn via Git Bash" [shape=box];
    "Done" [shape=box];
    "Abort" [shape=box];

    "Know prompt path?" -> "Know skill prefix (if any)?" [label="yes"];
    "Know prompt path?" -> "Ask human for missing info" [label="no"];
    "Know skill prefix (if any)?" -> "Know session name?" [label="yes/none"];
    "Know skill prefix (if any)?" -> "Ask human for missing info" [label="unsure"];
    "Know session name?" -> "Build & show command" [label="yes"];
    "Know session name?" -> "Ask human for missing info" [label="no"];
    "Ask human for missing info" -> "Build & show command";
    "Build & show command" -> "User confirms?";
    "User confirms?" -> "Spawn via Git Bash" [label="yes"];
    "User confirms?" -> "Abort" [label="no"];
    "Spawn via Git Bash" -> "Done";
}

What to collect (ask if unknown)

Ask all unknowns in one message — never one at a time.

Skill prefix → slash command mapping

All archetypes are valid — including subagent-driven-development, interactive sessions, and prompts with no skill prefix at all.

Deprecated: /babysitter:yolo is no longer used in Claude Code — use /yolo for autonomous runs. A prompt whose frontmatter says archetype: babysitter:yolo still maps to the /yolo slash command.

The commands

With a skill:

(cd "<project-root>" && claude --dangerously-skip-permissions --bg \
  --name "<session-name>" \
  "/<skill-prefix> <abs-prompt-path>" &>/dev/null &)

Plain prompt (no skill prefix):

(cd "<project-root>" && claude --dangerously-skip-permissions --bg \
  --name "<session-name>" \
  "<abs-prompt-path>" &>/dev/null &)

Git Bash / WSL only — &>/dev/null & is Bash syntax, not native PowerShell. On Windows, run from Git Bash.

Before spawning

1. Show the exact command to the user
2. 📄 Prompt: \``
3. 🏷️ Session: \``
4. Wait for explicit yes — "sure", "go", "yes", "do it" all count

After spawning

• Session runs silently in background
• To check progress: open Claude Agents panel or run claude --resume
• If inbox writeback is set up in the prompt: run /mm update to sync

Do NOT spawn if

• Prompt file has TODO or {{...}} placeholders still in it
• Required skill not installed — check with ls ~/.claude/skills/ and ls ~/.claude/plugins/cache/
• A session for this task is already running