/workspace:spawn
Spawn parallel Claude Code sessions across multiple workspace projects simultaneously. Creates tmux windows named {project}-{nickname} for easy navigation.
Quick Start
/agileflow:workspace:spawn --projects "frontend,backend"Arguments
| Argument | Description |
|---|---|
--projects "a,b" | Comma-separated project names (required) |
--count N | Sessions per project (default: 1) |
--prompt TEXT | Initial prompt for each session |
Flags
| Flag | Description |
|---|---|
--dangerous | Use --dangerouslySkipPermissions |
--no-tmux | Output commands without spawning |
--no-claude | Create worktrees but don't start Claude |
How It Works
Multi-Repo Mode
- For each project,
cdinto the project directory - Spawn Claude Code with the project as working directory
- Create tmux windows named
{project}-{n}
Monorepo Mode
- For each project, create a git worktree for isolation
- Spawn Claude Code in the worktree
- Create tmux windows named
{project}-{n}
Examples
One session per project
/agileflow:workspace:spawn --projects "frontend,backend"Two sessions per project with initial prompt
/agileflow:workspace:spawn --projects "frontend,backend" --count 2 --prompt "/agileflow:babysit"Related Commands
- /workspace:init — Initialize the workspace
- /workspace:status — View cross-project sessions
- /session:spawn — Spawn sessions in a single project