An automated code review tool that works with GitHub Actions.

📘 New to GitHub Actions?
GitHub Actions is like an automated assistant for your repository. When someone opens a pull request, this tool will automatically run and provide AI-powered code review comments. You don't need to run anything manually - just add the files as described below, and the review will happen automatically on every pull request! powered by Anthropic's Claude AI that provides intelligent, context-aware code reviews on your pull requests.

• 🤖 Automated code review comments on pull requests
• 🎯 Intelligent line-specific suggestions with code examples
• 🔍 Support for file filtering via whitelist and blacklist patterns
• 🔄 Handles both inline comments and general review feedback
• 📝 Generates comprehensive review summaries
• 🚫 Avoids duplicate comments on the same issues

The easiest way to add this reviewer to your repository:

1. Copy the entire .github folder from this repository to your repository. This folder contains everything needed:
   • .github/workflows/pr-review.yml - the GitHub Action configuration
   • .github/scripts/pr_review.py - the review script

Your repository structure should look like this:

your-repository/
├── .github/
│   ├── workflows/
│   │   └── pr-review.yml    # Action configuration
│   └── scripts/
│       └── pr_review.py     # Review script
├── [your other files and folders]

2. Add your Anthropic API key to your repository secrets:
   • Go to Settings > Secrets and variables > Actions
   • Add a new secret named ANTHROPIC_API_KEY
   • Set the value to your Claude API key

You can control which files are reviewed using whitelist and blacklist patterns:

env:
  PR_REVIEW_WHITELIST: "*.py,*.js,src/*"  # Files to include
  PR_REVIEW_BLACKLIST: "tests/*,*.test.js" # Files to exclude

• Whitelist: Comma-separated glob patterns of files to review
• Blacklist: Comma-separated glob patterns of files to exclude
• If no whitelist is specified, all files are reviewed by default
• Blacklist takes precedence over whitelist

Example patterns:

• * - All files
• *.py - All Python files
• src/*.js - JavaScript files in the src directory
• frontend/**/*.tsx - All TypeScript React files in frontend directory
• tests/* - Exclude all files in tests directory
• *.test.js,*.spec.ts - Exclude test files

The action provides:

1. Inline comments on specific code lines with suggestions
2. A summary comment including:
   • List of reviewed files
   • List of skipped files
   • Number of suggestions
   • General comments for issues that couldn't be tied to specific lines

Requirements:

• Python 3.11+
• anthropic package
• PyGithub package

Local setup:

pip install anthropic PyGithub

MIT License - feel free to use and modify for your needs.

Contributions are welcome! Please feel free to submit a Pull Request.