AgileFlow

/session:spawn

PreviousNext

Spawn multiple parallel Claude Code sessions in git worktrees

/session:spawn

Spawn multiple parallel Claude Code sessions, each in its own git worktree with optional tmux integration for easy navigation.

Quick Start

/agileflow:session:spawn --count 3

Arguments

ArgumentDescription
--count NNumber of sessions to spawn
--branches a,b,cExplicit branch names for each session
--from-epic EP-XXXAuto-create branches from epic stories

Flags

FlagDescription
--initInitialize sessions with test verification
--no-tmuxSkip tmux window creation
--dangerousSkip safety confirmations

How It Works

  1. Creates N git worktrees from current branch
  2. Auto-copies .env files to each worktree
  3. Spawns Claude Code in tmux windows (one per session)
  4. Registers sessions in session state for tracking

Tmux Navigation

After spawning, use tmux key bindings to switch between sessions:

  • Ctrl+b n - Next session window
  • Ctrl+b p - Previous session window
  • Ctrl+b [number] - Jump to specific window
CommandPurpose
/session:statusView all session states
/session:resumeSwitch to a session
/session:cleanupClean up finished sessions
/session:endEnd current session