pr-review

Multi-Provider Interactive PR Review

Run three AI code reviewers in parallel on a PR, synthesize their findings, then interactively vet each issue before posting anything to GitHub.

The key principle: nothing gets posted to the PR until you've reviewed and approved it. You stay in control of every comment.

How It Works

1. Gather — build prompts from PR metadata (deterministic script)
2. Review — run Claude, Gemini, and Codex in parallel (none of them touch the PR)
3. Synthesize — read all raw reviewer outputs, cluster by root issue, build consensus (LLM)
4. Vet — walk through each finding interactively, discuss, approve or reject (LLM + user)
5. Post — submit approved findings as inline file-level comments (deterministic script)
6. Verdict — draft a PR-level review (approve/request changes/comment), let user edit, then post

Scripts in scripts/ handle deterministic work (prompt building, GitHub posting). The LLM handles semantic work (reading raw outputs, clustering duplicates, synthesizing consensus, interactive discussion).

Step 0: Locate the plugin

CLAUDE_PLUGIN_ROOT is set by Claude Code only — Codex sets no plugin-root variable at all, so it would expand to an empty string. Resolve the root once, then reuse it:

PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-}"
[ -f "$PLUGIN_ROOT/scripts/build_prompts.py" ] || PLUGIN_ROOT=$(
  find ~/.claude/plugins ~/.codex/plugins ~/.agents -path "*pr-review*" \
       -name build_prompts.py 2>/dev/null | head -1 | xargs -r dirname | xargs -r dirname
)
echo "$PLUGIN_ROOT"

Step 1: Build Prompts

Run the prompt builder script to fetch PR metadata and create prompt files:

uv run "$PLUGIN_ROOT/scripts/build_prompts.py" <PR_NUMBER> --out-dir /tmp

This outputs JSON with paths to per-provider prompts:

{
  "pr_number": 365,
  "pr_title": "MEWS Integration",
  "pr_url": "https://github.com/owner/repo/pull/365",
  "repo": "owner/repo",
  "commit_sha": "abc123...",
  "review_prompt_claude": "/tmp/pr-review-prompt-claude-365.md",
  "review_prompt_gemini": "/tmp/pr-review-prompt-gemini-365.md",
  "review_prompt_codex": "/tmp/pr-review-prompt-codex-365.md",
  "security_prompt_claude": "/tmp/pr-security-prompt-claude-365.md",
  "security_prompt_gemini": "/tmp/pr-security-prompt-gemini-365.md",
  "security_prompt_codex": "/tmp/pr-security-prompt-codex-365.md"
}