What is Swarm and why does it exist?
Swarm is a CLI tool that orchestrates a team of AI agents to process GitHub issues through the full software delivery pipeline. It takes an issue from assignment to a review-ready pull request — autonomously.
No manual coding. No copy-pasting prompts. No babysitting. Assign the issue, and Swarm handles the rest.
The Scope Agent analyses the issue, explores the codebase, and produces a detailed implementation plan. It identifies affected files, proposes specific changes, and assesses risk — all without writing a single line of code.
The Dev Agent takes the scope plan and implements it. It creates a feature branch in an isolated git worktree, writes the code, runs tests, commits, pushes, and opens a pull request via the GitHub CLI.
The Review Agent checks the PR diff against your project's coding paradigms. It looks for correctness, style compliance, edge cases, and security issues. It returns a verdict: PASS or REWORK.
If the review verdict is REWORK, the Rework Agent reads the feedback and fixes the issues. It commits, pushes, and the review cycle repeats — up to a configurable maximum (default: 3 cycles).
Pure bash. No frameworks, no package managers, no build step. Each file is a focused module that sources its dependencies explicitly. If you can read bash, you can understand and extend Swarm.
Agents do the work, but a human makes the final call. Every pipeline ends with a PR labelled FOR-ASSESSMENT — never an auto-merge. The review/rework loop catches the obvious issues so humans can focus on the subtle ones.