PRR — AI-Powered PR Review Plugin
PRR is a Claude Code plugin that runs parallel AI code reviews using Claude, Codex, Gemini, and opencode as independent reviewers, then synthesizes their findings through a Claude-powered arbiter that cross-examines each reviewer with follow-up questions before producing a final verdict, confidence score, and inline line comments ready to post to GitHub.
Prerequisites
Required:
Optional (enable additional reviewers):
- Codex CLI — for the
codex agent
- Gemini CLI — for the
gemini agent
- opencode — for the
opencode agent. Requires OPENAI_API_KEY exported in your shell (e.g., in ~/.zshrc) or opencode auth to be configured. PRR does not store this key.
Installation
Inside a Claude Code session:
/plugin marketplace add cfactolerin/prr
/plugin install prr@cfactolerin-prr
Quick Start
/prr:setup
Run once to configure your workspace path, GitHub username, and Jira credentials.
/prr:start https://github.com/owner/repo/pull/42
Start a full review. PRR gathers context, runs all configured agents in parallel, runs the arbiter, and walks you through posting comments.
Skills
| Skill | Description |
|---|
/prr:setup | First-time setup wizard — configures workspace, GitHub user, and Jira credentials |
/prr:start <pr> | Full review workflow: context, parallel agents, arbiter synthesis, comment posting |
/prr:add-agent <name> | Enable an agent (claude, codex, gemini, opencode) in your config |
/prr:delete-agent <name> | Remove an agent from your config |
/prr:cleanup | Remove workspace entries for merged or closed PRs |
How It Works
- Context gathering — PRR clones the repo, checks out the PR branch, fetches the diff, and downloads any linked Jira ticket and Confluence pages into a local context directory.
- Parallel review — All configured agents (Claude, Codex, Gemini, opencode) receive the same review prompt and run simultaneously, each writing an independent
*-review.md to the results directory.
- Arbiter synthesis — A Claude arbiter reads all reviews, asks targeted follow-up questions of individual agents (up to N configurable rounds), then produces a final report with a verdict, confidence level, and checked line comments.
- Interactive investigation — You can ask questions about findings, read code, run git blame, or trigger a re-review with additional guidance before proceeding.
- Comment posting — PRR presents each proposed line comment for your review (accept, edit, clarify, or reject), then posts the approved set as a GitHub PR review via
gh api.
Agent Management
Add an agent:
/prr:add-agent codex
/prr:add-agent gemini
/prr:add-agent opencode
Remove an agent:
/prr:delete-agent gemini
The agents list in ~/.prr/config.yml controls which agents run on every review.
Configuration
Config lives at ~/.prr/config.yml. All keys are optional — defaults are shown below.
| Key | Default | Description |
|---|
workspace_path | ~/.prr/workspace | Where repos are cloned and results are stored |
agents | ["claude"] | Active reviewer agents |
claude_timeout | 600 | Seconds before Claude reviewer times out |
codex_timeout | 900 | Seconds before Codex reviewer times out |
gemini_timeout | 300 | Seconds before Gemini reviewer times out |
opencode_timeout | 900 | Seconds before opencode reviewer times out |
gemini_model | gemini-2.5-flash | Gemini model name passed to the CLI |
arbiter_rounds | 3 | Maximum Q&A rounds before the arbiter is forced to finalize |
jira_base_url | (empty) | Your Jira instance URL (e.g. https://yourorg.atlassian.net) |
jira_email | (empty) | Jira account email for Basic auth |
jira_api_token | (empty) | Jira API token |
Data Storage
PRR stores all configuration and review data locally:
| What | Where |
|---|
| Config (settings, Jira creds) | ~/.prr/config.yml |
| Cloned repos, diffs, reviews | ~/.prr/workspace/ (configurable) |
Note: ~/.prr/config.yml contains your Jira API token in plaintext. Do not commit this file to any repository. It is created per-user by /prr:setup and should stay in your home directory.
Uninstalling
Inside a Claude Code session:
/plugin uninstall prr@cfactolerin-prr
To also remove configuration and cached review data:
rm -rf ~/.prr
Building from Source
A universal macOS binary is included at bin/prr-darwin-universal. To rebuild it yourself:
./scripts/build-universal.sh
Or manually:
