25 KiB
Installation Guide | Usage Guide | Tools Guide | Qodo Merge 💎
Open-Source AI-Powered Code Review Tool
PR-Agent is an open-source, AI-powered code review agent. It is the legacy project from which Qodo Merge 💎, a separate commercial product, originated. PR-Agent is maintained by the community as a gift to the community. We are looking for additional maintainers to help shape its future; please contact us if you are interested.
Qodo Merge 💎 is a separate, enterprise-grade product with its own distinct features, zero-setup, and priority support.
Quick Start Options
| Option | Best For | Setup Time | Cost |
|---|---|---|---|
| PR-Agent (Open Source) | Developers who want full control, self-hosting, or custom integrations | 5-15 minutes | Free |
| Qodo Merge | Teams wanting zero-setup, enhancing the open-source features, additional enterprise features, and managed hosting | 2 minutes | Free tier available |
Table of Contents
- PR-Agent vs Qodo Merge
- Getting Started
- Why Use PR-Agent?
- Features
- See It in Action
- Try It Now
- Qodo Merge 💎
- How It Works
- Data Privacy
- Contributing
- Links
PR-Agent vs Qodo Merge
PR-Agent and Qodo Merge are now two completely different products that share a common history. PR-Agent is the original, legacy open-source project. Qodo Merge was initially built upon PR-Agent but has since evolved into a distinct product with a different feature set.
PR-Agent (This Repository) - Open Source
✅ What you get:
- Complete source code access and customization
- Self-hosted deployment options
- Core AI review tools (
/describe,/review,/improve,/ask) - Support for GitHub, GitLab, BitBucket, Azure DevOps
- CLI usage for local development
- Free forever
⚙️ What you need to manage:
- Your own API keys (OpenAI, Claude, etc.)
- Infrastructure and hosting
- Updates and maintenance
- Configuration management
Qodo Merge - A Separate Product
✅ What you get (everything above plus):
- Zero-setup installation (2-minute GitHub app install)
- Managed infrastructure and automatic updates
- Advanced features: CI feedback, code suggestions tracking, compliance (rules), custom prompts, and more
- Priority support and feature requests
- Enhanced privacy with zero data retention
- Free tier: 75 PR reviews/month per organization
💰 Pricing:
- Free tier available
- Paid plans for unlimited usage
- View pricing details
👨💻 Developer Recommendation: Start with PR-Agent if you want to experiment, customize heavily, or have specific self-hosting requirements. Choose Qodo Merge if you want to focus on coding rather than tool maintenance.
Getting Started
🚀 Quick Start for PR-Agent (Open Source)
1. Try it Instantly (No Setup)
Test PR-Agent on any public GitHub repository by commenting @CodiumAI-Agent /improve
2. GitHub Action (Recommended)
Add automated PR reviews to your repository with a simple workflow file:
# .github/workflows/pr-agent.yml
name: PR Agent
on:
pull_request:
types: [opened, synchronize]
jobs:
pr_agent_job:
runs-on: ubuntu-latest
steps:
- name: PR Agent action step
uses: Codium-ai/pr-agent@main
env:
OPENAI_KEY: ${{ secrets.OPENAI_KEY }}
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
Full GitHub Action setup guide
3. CLI Usage (Local Development)
Run PR-Agent locally on your repository:
pip install pr-agent
export OPENAI_KEY=your_key_here
pr-agent --pr_url https://github.com/owner/repo/pull/123 review
4. Other Platforms
💎 Try Qodo Merge (Zero Setup)
If you prefer a hosted solution without managing infrastructure:
- Install Qodo Merge GitHub App (2 minutes)
- FREE for Open Source: Full features, zero cost for public repos
- Free Tier: 75 PR reviews/month for private repos
- View Plans & Pricing
Complete Qodo Merge setup guide
💻 Local IDE Integration
Receive automatic feedback in your IDE after each commit: Qodo Merge post-commit agent
Why Use PR-Agent?
🎯 Built for Real Development Teams
Fast & Affordable: Each tool (/review, /improve, /ask) uses a single LLM call (~30 seconds, low cost)
Handles Any PR Size: Our PR Compression strategy effectively processes both small and large PRs
Highly Customizable: JSON-based prompting allows easy customization of review categories and behavior via configuration files
Platform Agnostic:
- Git Providers: GitHub, GitLab, BitBucket, Azure DevOps, Gitea
- Deployment: CLI, GitHub Actions, Docker, self-hosted, webhooks
- AI Models: OpenAI GPT, Claude, Deepseek, and more
Open Source Benefits:
- Full control over your data and infrastructure
- Customize prompts and behavior for your team's needs
- No vendor lock-in
- Community-driven development
Features
PR-Agent and Qodo Merge offer comprehensive pull request functionalities integrated with various git providers:
- 💎 means this feature is available only in Qodo Merge
See It in Action
/describe
/review
/improve
Try It Now
Try the GPT-5 powered PR-Agent instantly on your public GitHub repository. Just mention @CodiumAI-Agent and add the desired command in any PR comment. The agent will generate a response based on your command.
For example, add a comment to any pull request with the following text:
@CodiumAI-Agent /review
and the agent will respond with a review of your PR.
Note that this is a promotional bot, suitable only for initial experimentation.
It does not have 'edit' access to your repo, for example, so it cannot update the PR description or add labels (@CodiumAI-Agent /describe will publish PR description as a comment). In addition, the bot cannot be used on private repositories, as it does not have access to the files there.
Qodo Merge 💎
Qodo Merge is a separate, enterprise-grade product that originated from the open-source PR-Agent.
Key Differences from Open Source PR-Agent:
Infrastructure & Management:
- Fully managed hosting and automatic updates
- Zero-setup installation (GitHub/GitLab/BitBucket app)
- No need to manage API keys or infrastructure
Enhanced Privacy:
- Zero data retention policy
- No data used for model training
- Enterprise-grade security
Additional Features:
- Advanced code suggestions with tracking
- CI feedback analysis
- Custom prompts and labels
- Static code analysis integration
- Priority support
Pricing:
- Free tier: 75 PR reviews/month per organization
- Paid plans for unlimited usage
- Free for open source projects
See complete feature comparison for detailed differences.
How It Works
The following diagram illustrates PR-Agent tools and their flow:
Check out the PR Compression strategy page for more details on how we convert a code diff to a manageable LLM prompt
Data Privacy
Self-hosted PR-Agent
- If you host PR-Agent with your OpenAI API key, it is between you and OpenAI. You can read their API data privacy policy here: https://openai.com/enterprise-privacy
Qodo-hosted Qodo Merge 💎
-
When using Qodo Merge 💎, hosted by Qodo, we will not store any of your data, nor will we use it for training. You will also benefit from an OpenAI account with zero data retention.
-
For certain clients, Qodo-hosted Qodo Merge will use Qodo’s proprietary models — if this is the case, you will be notified.
-
No passive collection of Code and Pull Requests’ data — Qodo Merge will be active only when you invoke it, and it will then extract and analyze only data relevant to the executed command and queried pull request.
Qodo Merge Chrome extension
- The Qodo Merge Chrome extension serves solely to modify the visual appearance of a GitHub PR screen. It does not transmit any user's repo or pull request code. Code is only sent for processing when a user submits a GitHub comment that activates a PR-Agent tool, in accordance with the standard privacy policy of Qodo-Merge.
Contributing
To contribute to the project, get started by reading our Contributing Guide.
Links
- Discord community: https://discord.com/invite/SgSxuQ65GF
- Qodo site: https://www.qodo.ai/
- Blog: https://www.qodo.ai/blog/
- Troubleshooting: https://www.qodo.ai/blog/technical-faq-and-troubleshooting/
- Support: support@qodo.ai