🔍 Code Review Automation

Automated code review for GitHub pull requests using Claude LLM

Automatically analyze GitHub pull requests, provide intelligent code reviews, security scanning, and style checking using Claude AI.

✨ Features

• - PR Listing - View all pull requests in a repository
• PR Details - Get comprehensive information about any PR
• File Changes - See exactly what files changed
• PR Search - Search PRs by keyword
• Repository Info - Get general repository statistics
• Claude Analysis - AI-powered code review using Claude LLM
• Code Quality Scoring - Automated quality assessment (0-100)
• Security Scanning - Automated security vulnerability detection
• Style Checking - Automated style and linting checks
• Full Review - Complete review with all checks
• Configurable - Custom rules via INLINECODE0

🚀 Quick Start

1. Install Dependencies

CODEBLOCK0

2. Setup GitHub API Token

Get your GitHub Personal Access Token:

1. 1. Go to GitHub Settings → Developer settings → Personal access tokens
2. Generate a new token with repo scope
3. Create .env file:

CODEBLOCK1

3. Review Pull Requests

CODEBLOCK2

📋 Commands

list-prs

CODEBLOCK3

Options:

• - --state: PR state (open, closed, all) - default: open
• INLINECODE5: Maximum PRs to show - default: 10

pr-info

CODEBLOCK4

Shows:

• - Title and description
• Author and timestamps
• File change statistics
• Labels and merge status

pr-files

CODEBLOCK5

Shows:

• - Changed files
• Status (added, modified, deleted)
• Additions and deletions per file

search-prs

CODEBLOCK6

Options:

• - --query: Search keyword (required)
• INLINECODE10: PR state (open, closed, all) - default: open
• INLINECODE11: Maximum PRs to show - default: 10

repo-info

CODEBLOCK7

Shows:

• - Repository name and description
• Programming language
• Stars and forks count
• Open issues and PRs
• Creation and update dates

review-pr

CODEBLOCK8

Shows:

• - AI-powered code review
• Code quality score (0-100)
• Security considerations
• Best practices
• Specific recommendations

Requires:

• - GITHUB_TOKEN in INLINECODE15
• INLINECODE16 in INLINECODE17

security-scan

CODEBLOCK9

Detects:

• - Exposed secrets (API keys, tokens, passwords)
• SQL injection vulnerabilities
• Command injection vulnerabilities
• Hardcoded credentials
• Weak cryptography (MD5, SHA1, RC4, DES)
• Unsafe deserialization (pickle)

Options:

• - --config: Configuration file path

style-check

CODEBLOCK10

Checks:

• - Line length violations
• Naming convention violations
• Import order
• Blank lines
• Whitespace issues
• Missing docstrings

Options:

• - --config: Configuration file path

full-review

CODEBLOCK11

Combines:

• - LLM analysis (code quality score)
• Security scanning
• Style checking

Options:

• - --config: Configuration file path
• INLINECODE24: Skip LLM analysis
• INLINECODE25: Skip security scan
• INLINECODE26: Skip style check

config-init

CODEBLOCK12

Creates a .reviewrc file with customizable settings for:

• - Security scanning rules
• Style checking rules
• LLM analysis settings

🔧 Technical Details

GitHub API Integration

• - Uses PyGithub library
• Authenticates with Personal Access Token
• Rate limit handled automatically

LLM Integration

• - Claude API for code analysis
• Intelligent code review comments
• Context-aware suggestions
• Code quality scoring

Security Scanning

• - Static analysis for common vulnerabilities
• Pattern-based detection
• Severity-based categorization
• Configurable rules

Style Checking

• - PEP8 compliance checks
• Naming convention validation
• Line length enforcement
• Import order verification
• Whitespace checks

Configuration

• - YAML/JSON config files
• Project-specific settings
• Customizable thresholds
• INLINECODE29 support

📊 Examples

CODEBLOCK13

🔐 Security

• - GitHub PAT stored in .env file (never committed)
• No secrets logged or displayed
• IP whitelist recommended

🚧 Roadmap

v0.2.0 - Claude Integration (Completed)

• - Claude API integration
• Automated PR analysis
• Intelligent review comments
• Code quality scoring

v0.3.0 - Security & Style (Current)

• - Security vulnerability scanning
• Style and linting checks
• Automated fix suggestions
• Configuration file support
• Full review command

v1.0.0 (Planned)

• - Multi-platform support (GitLab, Bitbucket)
• CI/CD integration
• Team collaboration features
• Review dashboard

📄 License

MIT

🙋 Support

For issues or questions:

• - Check the documentation
• Open an issue on GitHub