claude-review

AI-powered PR review agent using Claude Code CLI.

Prerequisites

• GitHub CLI (gh) — authenticated
• Claude Code CLI (claude) — with valid API key
• Python 3.10+

Usage

# Review a PR (prints to stdout)
python3 claude_review.py --pr https://github.com/owner/repo/pull/123

# Save to file
python3 claude_review.py --pr https://github.com/owner/repo/pull/123 -o review.md

Output Format

The tool produces structured Markdown with:

• Summary — 2-3 sentences describing the change
• Identified Risks — potential bugs, security issues, or concerns
• Improvement Suggestions — actionable recommendations
• Confidence Score — Low / Medium / High based on diff complexity

GitHub Actions

The included workflow (.github/workflows/pr-review.yml) automatically reviews PRs when opened or updated.

Setup

1. Add ANTHROPIC_API_KEY to your repo's secrets (Settings → Secrets → Actions)
2. The workflow uses GITHUB_TOKEN automatically for gh CLI access

How it works

On every PR open/sync:

1. Checks out the code
2. Installs Claude Code CLI
3. Runs claude_review.py against the PR
4. Posts the review as a PR comment

Examples

See examples/ for sample outputs from real PRs.

License

MIT