swarm

# Swarm Launch a production Agent Toolkit swarm from any natural language request via the `agent-toolkit swarm` CLI. Herdr is the default UI for an excellent interactive experience; tmux is the isolated fallback. ## When to use - User says "launch a swarm", "start a swarm", "swarm this task", or describes parallel/team work that benefits from multiple agents. - Any task that mentions swarm, pair/team/full, Herdr, tmux, or worktree-per-writer. - User wants to reuse an existing swarm run for a new request (same windows, new handoff). ## Prerequisites - `agent-toolkit` installed and on PATH (`agent-toolkit swarm doctor` should pass). - For Herdr: `herdr` CLI installed (`herdr --version`); Herdr daemon running. - For tmux: `tmux` installed; isolated socket is `agent-toolkit-swarm-<run-id>`. - Run inside a Git repo (or pass `--workspace /path/to/repo`). - Optional: `~/.config/agent-toolkit/swarm.yaml` for model-profile mapping (`economy` → `opencode/mimo-v2.5-free`, `balanced` → provider default). ## Workflow ### 1. Inspect intent Extract from the user prompt: - **Task**: free-form objective (if missing, start swarm ready for interactive input). - **Recipe**: `pair` (2 roles: implementer→reviewer, fast), `team` (implementer→reviewer→integrator), `full` (large, 5+ roles). Default `pair` unless task needs more. - **Runner**: `opencode` (default, free models) or `claude` (Anthropic). Respect `--runner` if user names it. - **Model profile**: `economy` (`opencode/mimo-v2.5-free...