What problem does it solve?
This skill orchestrates parallel autonomous workers by spawning isolated agents with fresh context for each task, enabling scalable execution of multiple beads or issues in parallel.
Core Features & Use Cases
- Local mode: Claude-native task tooling with fast background workers
- Distributed mode: tmux sessions + Agent Mail for persistent, isolated workers
- Wave-based execution: spawn a new team per wave to ensure fresh context
- Pre-assigned tasks: mayor assigns tasks before spawning to avoid race conditions
- Retry and validation: workers can report progress and issues; validation checks gate completion
Quick Start
To start a wave, run /swarm. For a distributed setup, ensure the environment supports tmux and Agent Mail, then run /swarm --mode=distributed. See references for deeper workflow details.