~ pr-review
5 AI providers · no API keys · 100% CLI

~ pr-review

AI-powered pull request reviews, right in your terminal.
Pick your AI, run the command, get a structured report.

Get Started Documentation
Install
npm install -g pull-request-review

5 AI Providers

Each provider uses its own installed CLI — no configuration needed.

🤖
Claude
claude --print
🐙
GitHub Copilot
copilot -p
⚡
OpenAI Codex
codex -q
💎
Gemini
gemini -p
🖱️
Cursor
agent -p

One command.
Complete review.

Run pr-review inside any git repository. Interactive menus guide you through provider and model selection. The diff is sent to your chosen AI, and a structured Markdown report is saved automatically.

  • Auto-detects your current branch
  • Detects open PR number via gh CLI
  • Excludes lock files per config
  • Remembers last-used model per provider
Quick Start Guide
terminal
$ pr-review

┌─────────────────────────────────────┐
   🔍  pr-review — AI Code Review      
└─────────────────────────────────────┘

  Config: ~/.pr-review/config.json

  Select AI provider:

  ❯ Claude (Anthropic)  — Uses local claude CLI — no API key needed
    GitHub Copilot      — Uses copilot CLI — run `copilot /login` first
    OpenAI Codex        — Uses codex CLI — run `codex` once to sign in
    Google Gemini       — Uses gemini CLI — run `gemini` once to authenticate
    Cursor              — Uses agent CLI — install Cursor + add agent to PATH

  → Claude (Anthropic)

  Select Claude model:

  ❯ claude-sonnet-4-6  · Recommended
    claude-opus-4-6    · Most capable
    claude-haiku-4-5   · Fastest
    claude-sonnet-4-5
    claude-sonnet-4

  → claude-sonnet-4-6

  Source branch     (default: feature/auth): 
  Destination branch (default: main): 

✔ Diff fetched — 3,842 chars
✔ Claude review received
✔ Report saved → pr-42-review.md

✅ PR Review complete!
   Open pr-42-review.md to read the review.

Everything you need

Built for developers who care about code quality.

5 AI Providers

Choose from Claude, GitHub Copilot, Codex, Gemini, or Cursor. Each provider uses its native CLI — no API keys required.

Auto PR Detection

Automatically fetches the open PR number via gh CLI and names your report pr-42-review.md for easy tracking.

Interactive Menus

Guided prompts walk you through provider, model, and branch selection with smart defaults remembered per provider.

Security Focused

The AI review prompt is engineered for bugs, security vulnerabilities, performance issues, and best practices.

Structured Reports

Outputs a polished Markdown report with sections for Summary, Critical Issues, Security, Performance, and a Final Verdict.

Config System

Global ~/.pr-review/config.json stores defaults. Override anything per-run with CLI flags like --model or --focus.

~/.pr-review/config.json
{
  "defaultProvider": "claude",
  "defaultModels": {
    "claude": "claude-sonnet-4-6",
    "copilot": "claude-sonnet-4.6",
    "codex": "gpt-5.4",
    "gemini": "flash",
    "cursor": "default"
  },
  "defaultBaseBranch": "main",
  "maxDiffLength": 100000,
  "ignoreFiles": ["package-lock.json", "yarn.lock"],
  "outputFile": "pr-review-review.md"
}

Global config,
zero friction.

On first run, ~/.pr-review/config.json is created automatically. Set your preferred provider, models, base branch, and more. Override any setting per-run with CLI flags.

pr-review configView & update settings interactively
pr-review review --stagedReview only staged changes
pr-review review --model=opusOverride model for this run
pr-review review --focus=securityFocus on security issues only

Simple usage.
Powerful output.

Every review generates a structured Markdown report with Summary, Critical Issues, Improvements, Security concerns, Performance notes, and a Final Verdict.

## Summary
## Critical Issues
## Suggested Improvements
## Security Analysis
## Performance Notes
## Final Verdict
Usage
# Run inside any git repo
pr-review

# Select provider → model → branches
# → Diff is fetched, AI review generated
# → Report saved as pr-42-review.md
Available on npm

Ready to review smarter?

Install once, use everywhere. Works in any git repository.

npm install -g pull-request-review
Read the Docs Installation Guide