Documentation

1 Install DiffSwarm

$ brew tap bro4all/diffswarm
$ brew install diffswarm

# Or grab a binary from GitHub Releases:
# https://github.com/bro4all/pr-reviewer/releases/latest

2 Install a runtime engine

DiffSwarm needs a local AI engine. Install at least one:

# OpenAI Codex CLI
$ npm install -g @openai/codex

# Anthropic Claude Code
$ npm install -g @anthropic-ai/claude-code

3 Authenticate your engine

# Codex
$ codex login
# or: printenv OPENAI_API_KEY | codex login --with-api-key

# Claude Code
$ claude setup-token

4 Login to DiffSwarm

$ diffswarm login
# Enter your purchase email + one-time code from inbox

5 Run reviews

# GitHub PR
$ diffswarm pr https://github.com/ORG/REPO/pull/123 --out report.md

# Local diff
$ diffswarm diff path/to/changes.diff --out report.md

# Post findings as a PR comment
$ diffswarm pr https://github.com/ORG/REPO/pull/123 --comment

# Smoke test (no LLM calls, no subscription needed)
$ diffswarm diff tests/fixtures/sample.diff --dry-run

CLI reference

--engine codex|claude                # AI engine (default: codex)
--profile cheap|balanced|thorough     # review depth
--out FILE                           # write Markdown report
--json FILE                          # write JSON findings
--comment                            # post to PR
--model MODEL                        # override model
--fleet-size N                       # parallel agent count
--dry-run                            # skip LLM calls