Installation Guide | Usage Guide | Tools Guide | Qodo Merge 💎

Open-Source AI-Powered Code Review Tool

PR-Agent is a free, open-source tool that provides AI-powered code review and PR assistance. Run it locally, on your CI/CD, or self-host it.

Qodo Merge 💎 is the hosted, enterprise version with additional 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 (This Repository) - Open Source

✅ What you get:

• Complete source code access and customization
• Self-hosted deployment options
• All 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 - Hosted Solution

✅ 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, custom prompts
• 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

Complete CLI setup guide

4. Other Platforms

• GitLab webhook setup
• BitBucket app installation
• Azure DevOps setup

💎 Try Qodo Merge (Zero Setup)

If you prefer a hosted solution without managing infrastructure:

1. Install Qodo Merge GitHub App (2 minutes)
2. FREE for Open Source: Full features, zero cost for public repos
3. Free Tier: 75 PR reviews/month for private repos
4. 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:

		GitHub	GitLab	Bitbucket	Azure DevOps	Gitea
TOOLS	Describe	✅	✅	✅	✅	✅
	Review	✅	✅	✅	✅	✅
	Improve	✅	✅	✅	✅	✅
	Ask	✅	✅	✅	✅
	⮑ Ask on code lines	✅	✅
	Help Docs	✅	✅	✅
	Update CHANGELOG	✅	✅	✅	✅
	Add Documentation 💎	✅	✅
	Analyze 💎	✅	✅
	Auto-Approve 💎	✅	✅	✅
	CI Feedback 💎	✅
	Compliance 💎	✅	✅	✅
	Custom Prompt 💎	✅	✅	✅
	Generate Custom Labels 💎	✅	✅
	Generate Tests 💎	✅	✅
	Implement 💎	✅	✅	✅
	Scan Repo Discussions 💎	✅
	Similar Code 💎	✅
	Utilizing Best Practices 💎	✅	✅	✅
	PR Chat 💎	✅
	PR to Ticket 💎	✅	✅	✅
	Suggestion Tracking 💎	✅	✅
USAGE	CLI	✅	✅	✅	✅	✅
	App / webhook	✅	✅	✅	✅	✅
	Tagging bot	✅
	Actions	✅	✅	✅	✅
CORE	Adaptive and token-aware file patch fitting	✅	✅	✅	✅
	Auto Best Practices 💎	✅
	Chat on code suggestions	✅	✅
	Code Validation 💎	✅	✅	✅	✅
	Dynamic context	✅	✅	✅	✅
	Fetching ticket context	✅	✅	✅
	Global and wiki configurations 💎	✅	✅	✅
	Impact Evaluation 💎	✅	✅
	Incremental Update	✅
	Interactivity	✅	✅
	Local and global metadata	✅	✅	✅	✅
	Multiple models support	✅	✅	✅	✅
	PR compression	✅	✅	✅	✅
	PR interactive actions 💎	✅	✅
	RAG context enrichment	✅		✅
	Self reflection	✅	✅	✅	✅
	Static code analysis 💎	✅	✅

• 💎 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 the hosted version of PR-Agent with additional enterprise features.

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: [email protected]