pr-review

pr-review

A generic, plugin-based PR review tool for GitHub and Azure DevOps, packaged as a plugin for Copilot CLI or Claude Code. Orchestrates parallel reviewer agents in a single agent session (companion plugins optional) and posts every finding back to the PR as a resolvable inline review comment — never a top-level comment, nothing dropped. When the codex CLI is installed, a Codex second-opinion reviewer runs alongside automatically.

/pr-review https://github.com/org/repo/pull/123
/pr-review https://dev.azure.com/org/proj/_git/repo/pullrequest/456 --dry-run

Why a CLI, not just a skill

LLMs are unreliable at gathering metadata, deduplicating findings, and posting comments. A thin Node CLI handles those deterministic tasks; reviewer agents only do the actual reviewing. See architecture for the full execution model.

Install

Inside a copilot session:

/plugin marketplace add guimatheus92/pr-review
/plugin install pr-review@pr-review

Or inside a claude (Claude Code) session:

/plugin marketplace add guimatheus92/pr-review
/plugin install pr-review@pr-review

No npm install needed. The plugin ships a pre-bundled dist/cli.cjs; the slash command finds it via $CLAUDE_PLUGIN_ROOT under Claude Code (falling back to ~/.copilot/installed-plugins/) and runs it with node. The plugin layout (commands/, agents/, skills/) loads in both hosts; the manifest lives in two places on purpose — .claude-plugin/plugin.json (Claude Code's canonical location) and a root plugin.json (which Copilot CLI requires).

Command name per host: Copilot CLI exposes the command as /pr-review. Claude Code namespaces plugin commands as /pr-review:pr-review — and because this plugin also ships reviewer agents, Claude Code does not register a bare /pr-review alias for it (empirically: plugins that ship agents don't get the bare form; it's a host behavior, not configurable in the plugin). To get a bare /pr-review under Claude Code, drop a personal command at ~/.claude/commands/pr-review.md (personal commands have no namespace, so /pr-review resolves):

---
description: Bare alias for the pr-review plugin command.
argument-hint: "<pr-url> [flags]"
allowed-tools: ["Bash"]
---
Run the pr-review CLI in the background and poll it (you are plumbing, not the reviewer):
​```bash
CLI=$(find ~/.claude/plugins/cache -name cli.cjs -path '*/pr-review/*/dist/*' -not -path '*/node_modules/*' 2>/dev/null | sort | tail -1)
node "$CLI" review $ARGUMENTS --detach
​```
If the output has a `run-id:`, poll `node "$CLI" status <run-id>` (~25s apart) until it prints the summary; otherwise print the output verbatim.

For local development:

git clone https://github.com/guimatheus92/pr-review && cd pr-review
npm install && npm run build
# inside copilot (or claude — same slash commands; claude also accepts `claude plugin marketplace add ./` from the shell):
/plugin marketplace add .
/plugin install pr-review@pr-review

Authentication

Provider	Env var	Fallback
GitHub	GITHUB_TOKEN / GH_TOKEN / COPILOT_GITHUB_TOKEN	gh auth token
Azure DevOps	AZURE_DEVOPS_PAT / SYSTEM_ACCESSTOKEN	none

Usage

/pr-review <pr-url>                    # review with auto-discovered skills; posts line comments (default)
/pr-review <pr-url> --dry-run          # preview findings without posting
/pr-review <pr-url> --skip security    # skip specific reviewers
/pr-review <pr-url> --context-only     # prepare context + skill routing table, don't run reviewers
/pr-review <pr-url> --lang pt-BR       # language for finding titles/bodies (default: en)
/pr-review <pr-url> --fail-on high     # exit 1 if any high/critical finding survives dedupe
/pr-review <pr-url> --runtime claude   # host the session in Claude Code instead of Copilot CLI
/pr-review <pr-url> --no-codex         # skip the Codex second-opinion reviewer

Exit codes: 0 clean, 1 findings at/above --fail-on, 2 pipeline error (including an orchestrator run that produced no parseable findings).

Posting guarantees

On a publish run (the default), every finding lands as a resolvable inline review thread — so each one can be discussed and resolved in place: