01 -Overview
Many AI agents on the problem. One answer back.
Agent Swarm runs several agents on the same question in parallel, each in a different role, and merges their answers into one deterministic synthesis. Start with a bundled swarm - say, for reviewing a diff or getting customer-style feedback on a launch - or build your own.
Run one in a line
Start with a bundled swarm - no configuration required:
# install
npm install -g @calvinnwq/agent-swarm
# run a bundled swarm against a question (2 = rounds)
agent-swarm run 2 "Should we ship the freemium tier this quarter?" \
--preset customer-panelEvery agent runs at the same time, so a four-agent panel takes about as long as one. You get back a single synthesis you can read, review, or check in.
Ready-made swarms
Each bundled preset has its own roster of agents and its own decision vocabulary. Pick one, or use it as a starting point for your own.
Adversarial code review
code-reviewer · implementation-skeptic · test-risk-reviewer
Three reviewers attack a diff, PR plan, or architecture change from different angles.
Customer panel
first-time-user · busy-operator · skeptical-buyer
Stand-in customers react to your product's first-run value, friction, and adoption risk.
Product decision
product-manager · principal-engineer
A PM frames user value and a principal engineer grounds feasibility; they converge on a call.
Build your own ✦
your roles · your rounds · your decision words
Define agents in .agent-swarm/agents/*.md, wire them into a preset. Pick the rounds, the resolution, even the verdict vocabulary.
What you get back
The synthesis collects one recommendation in the swarm's own decision vocabulary, how much the panel agreed, the risks they share, and what's still open. No model decides the final word, so the same agent notes always produce the same synthesis.
Fix now - onboarding hides the one action that shows value.
Where next
- Quickstart - run a ready-made swarm end to end.
- CLI reference - every command, flag, preset, and run artifact.
- Architecture - the runtime map for contributors.