What Swarm does
Swarm breaks a spec into tasks, runs them in parallel as autonomous coding agents, reviews the output, and opens pull requests. You provide a spec (Markdown) and credentials; the swarm handles planning → execution → review → PR. It routes across providers (Anthropic, OpenAI, Gemini, Bedrock, and more) per phase and per task.
Pipeline order: plan → execute → [test] → [review + fix] → integration validation → [PR].
Your first run
- 1Make sure you belong to an organization at /orgs. Organizations are provisioned centrally by a platform admin; once you belong to one, all credentials, repos, and runs are shared across its members.
- 2Open /settings and fill in:
- GitHub token — needs
repoandworkflowscopes - A provider key — e.g. an Anthropic API key (or Bedrock / OpenAI / Gemini credentials)
- Repos — one or more GitHub clone URLs
- GitHub token — needs
- 3Go to /new, paste a Markdown spec, pick options, click Start run.
- 4Watch the run on its detail page — tasks stream live, each with its own logs, diff, and cost.
- 5When done, the engine opens a PR (unless you checked Skip PR creation).
Keep in mind — the spec is the single biggest lever on output quality — a clear, scoped Markdown spec yields a sharper task breakdown than a vague one. One PR is opened per repo per run; re-running PR creation is idempotent.