PR Agent
Same first pass every PR gets, without a per-seat bill. You run the service and Postgres, and you own the GitHub App credentials and model keys. Model-backed work sends the review context to the provider you configure.
MIT licensed. Hosting and AI usage on you.
One deploy. After that, every pull request follows the same path inside GitHub. No extra dashboard, no per-seat bill from PR Agent.
Install PR Agent beside the rest of your stack. Your GitHub credentials and AI keys stay in your account, not a vendor dashboard.
Your servers · your keys
PR Agent notices and starts a review. Your team sees a reaction on the pull request so everyone knows work has begun.
Starts when a pull request opens
PR Agent looks at the branch and the changes, then hunts for bugs and correctness issues. When risky APIs show up, it also checks for security problems.
Review runs on your servers
Notes appear next to the changed lines, plus a short summary in the conversation. Want more? Comment /describe, /ask, /triage, or mention the bot. Replies stay in the same thread.
/review · /describe · /ask · /triage
Docs-only pull requests can take a lighter path. Very large changes may get a partial review, and PR Agent says what it could not cover instead of faking completeness.
Partial review notice when needed
Ask from a pull request comment, or let the automatic path run when a pull request opens.
/review
Comments land next to the lines that need attention.
/describe
Summary bullets and an optional diagram go into the PR body.
/ask
Get an answer in the same thread, right where the code lives.
/triage
Preview the would-be diff, then apply the approved set. Bare /triage still fixes without a preview.
automatic
Docs-only pull requests take a lighter path instead of a full review.
Same summary, description, ask, and triage formats PR Agent posts on a real pull request.
/review
A summary comment on the pull request conversation.
PR Agent
PR conversation comment
Note
| Size | M |
|---|---|
| P1 · c4 | Webhook ack can race the durable write On the diff · |
| P2 · c3 | Summary edit ignores stale head guard Summary only · |
| Relevant tests | partial |
| Security | None found on this pass |
Verify each finding against current code. Fix only still-valid issues./describe
A readable summary merged into the pull request body.
PR Agent
merged into the pull request body
Enhancement, Documentation
flowchart LR
Webhook --> Intake --> Queue --> ReviewWorkersrc/settings/constants.ts
/ask
A question and answer right on the pull request.
PR Agent
PR conversation reply
Question: Why is the retry wrapper needed around the webhook dispatcher?
Answer:
Transient GitHub 502s were dropping webhook deliveries before durable intake completed. The retry wrapper keeps the delivery alive long enough for the Postgres write and acknowledgement reaction to finish, then the worker picks up the agent work item.
/triage
Verdicts on earlier findings, with fixes pushed when they still apply.
PR Agent
PR conversation comment
Full PR triage.
Evaluated head: c4f8a91b2e3d4a5b6c7d8e9f0a1b2c3d4e5f6a7b
1 Fixed · 1 Already resolved · 0 Skipped · 1 Dismissed · 0 Previously resolved
Pushed commits:
a1b2c3d Fix webhook ack race (1 files, +12 -3)| Severity | Finding | Location | Verdict | Thread |
|---|---|---|---|---|
| P1 | Webhook ack can race the durable write | src/webhooks/intake.ts L148 | Fixed a1b2c3d | thread |
| P2 | Summary edit ignores stale head guard | src/review/publish.ts L91 | Already resolved | thread |
| P2 | Docs-only path skips durable ack wait | src/webhooks/intake.ts L162 | Dismissed | thread |
Commit these to .pr-agent/*.mdc to steer future reviews:
Create .pr-agent/src-webhooks-intake.mdc with:
---
globs:
- "src/webhooks/intake.ts"
alwaysApply: false
---
Intentional: docs-only PRs skip the durable ack wait by design.$0
Know the cost before you connect GitHub or add an AI provider.
$0 from PR Agent
No credit card. No per-seat fee. Open source under MIT.
Hosting and AI usage only
Cover your server, database, and model bills. Add more developers without raising your PR Agent bill.
Your security rules apply
Run it inside your network, choose your AI provider, and keep review traffic under your policies.
Use OpenAI, Anthropic, Google, DeepSeek, OpenRouter, Groq, and more with your own API keys.
Switch from GPT to Claude to DeepSeek by changing a setting. Your GitHub workflow stays the same. See Docker Compose setup or the repo README.
CodeRabbit, Greptile, Cursor Bugbot, and Macroscope sell hosted review. PR Agent is for teams that want the reviewer, the AI keys, and the review data in their own account.
| Tool | Deployment | Notes |
|---|---|---|
| PR Agent | Self-hosted, MIT-licensed | You run the reviewer, hold the model keys, and choose the model provider. |
| CodeRabbit | Cloud SaaS (self-host enterprise) | Hosted reviewer with subscription pricing and a managed data path. |
| Greptile | Cloud SaaS (self-host option) | Managed full-repo indexing for cross-file context. |
| Cursor Bugbot | Cloud (Cursor ecosystem) | Bug-focused review tied to the Cursor ecosystem. |
| Macroscope | Cloud SaaS | Hosted GitHub PR review with a managed pipeline. |
Three steps from an empty machine to a review on a real pull request. You need Docker, a GitHub app, and one AI provider key.
Register the app on your account or org, then point GitHub at the host where you will run PR Agent.
Need the click-by-click path? See README Host with Docker Compose.
Copy the example env, drop in your GitHub app values and provider key, then start PR Agent with Compose.
cp .env.example .env
# Fill GITHUB_*, WEBHOOK_SECRET, and your provider key
docker compose build
docker compose upMinimum keys to set
DATABASE_URL=postgres://...
GITHUB_APP_ID=...
GITHUB_APP_PRIVATE_KEY=...
WEBHOOK_SECRET=...
PI_PROVIDER=openai
PI_MODEL=gpt-4o-mini
OPENAI_API_KEY=sk-...Install the app on a repo, open a pull request, and wait for the automatic pass. Or type a command in the conversation when you want more.
/reviewRun a full review on the changes/describeWrite a readable summary into the PR body/ask …Ask a question about the code in that thread/triagePreview with /triage preview, apply with /triage all/triage previewShow the would-be unified diff. Nothing is pushed./triage allApply the previewed set. Optional exclude <thread ids>.