AI Code Review Setup Guide for GitHub
Complete step-by-step tutorial to integrate AI-powered code review with your GitHub repositories. Get automated feedback, bug detection, and security scanning in under 5 minutes.
Prerequisites
Required Access
- GitHub repository admin access
- Ability to install GitHub Apps
- Repository webhook permissions
Estimated Time
- 3-5 minutes: Initial setup
- 2-3 minutes: Configuration
- 1-2 minutes: Testing
Connect Your GitHub Account
Start by connecting your GitHub account to enable AI code review on your repositories. This creates the necessary authentication and permissions for automated reviews.
GitHub Integration Steps
- 1
Visit the GitHub Apps page
Navigate to your repository settings → Integrations → GitHub Apps
- 2
Install Propel AI Code Review App
Click "Install" on the Propel GitHub App and authorize access
- 3
Select repositories
Choose specific repositories or grant access to all repositories
Security Note
The GitHub App only requests the minimum permissions needed: repository content (read), pull requests (read/write), and checks (write). Your code never leaves your GitHub environment.
Configure Review Settings
Customize the AI review behavior to match your team's preferences and coding standards. These settings determine what types of feedback you'll receive and when.
Review Scope
Review Triggers
Recommended Settings for New Teams
Enable:
- ✓ Code quality issues
- ✓ Security vulnerabilities
- ✓ New pull requests
- ✓ Pull request updates
Start disabled:
- • Style and formatting (until team adapts)
- • Draft PRs (reduces noise)
- • Direct commits (for urgent hotfixes)
Test the Integration
Verify that AI code review is working correctly by creating a test pull request. This ensures the integration is properly configured and reviews are being generated.
Quick Test Process
Create a test branch
Add code with intentional issues
Create pull request
Expected Results
Within 30 seconds: AI review comments appear on the pull request
Check status: Propel AI Review check shows as completed
Review quality: Comments are specific, actionable, and line-specific
Advanced Configuration (Optional)
Fine-tune your AI code review setup with advanced features for specific use cases, team workflows, and integration requirements.
Branch Protection Rules
Require AI review approval before merging:
Repository → Settings → Branches → Add Rule
- ✓ Require status checks to pass
- ✓ Require "Propel AI Review" check
- ✓ Require branches to be up to date
Webhook Configuration
Custom webhook settings (advanced users):
Repository → Settings → Webhooks
- • Payload URL: Auto-configured
- • Content type: application/json
- • Events: Pull requests, Push
Team Customization Options
Review Frequency
- • Every commit
- • PR creation only
- • On-demand trigger
Comment Style
- • Detailed explanations
- • Brief suggestions
- • Code fix proposals
Integration Level
- • Advisory comments
- • Blocking reviews
- • Hybrid approach
Troubleshooting Common Issues
AI reviews not appearing on pull requests
Check webhook delivery in repository settings. Verify the GitHub App has repository access and pull request permissions.
Reviews taking longer than expected
Large pull requests (500+ lines) may take 2-3 minutes. Consider breaking up large changes into smaller, focused PRs.
Too many or too few review comments
Adjust review scope settings in the configuration dashboard. Start with 'High Priority Issues Only' for cleaner feedback.
