Create a new swarm team from a Beads epic with N worker agents
Create a tmux-persistent multi-agent swarm team for parallel task execution.
/swarm-create --epic <epic-id> --agents <count> [--isolation <mode>] [--dry-run]
| Argument | Required | Default | Description |
|---|---|---|---|
--epic | Yes | - | Beads epic ID to create swarm from |
--agents | No | 2 | Number of worker agents (max 4) |
--isolation | No | (ask user) | Isolation mode: shared or worktree |
--dry-run | No | false | Show what would be created without executing |
Default: Shared Mode - For most swarm operations, shared mode is recommended. Worktree mode adds complexity (merge step) and is only needed when agents might modify the same files. Shared mode worked well for the 6-phase Pulse Comments implementation (~$12-15 cost, 20 mins).
You MUST ask the user which isolation mode they want if not specified.
Use the AskUserQuestion tool: