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

PR-Agent aims to help efficiently review and handle pull requests, by providing AI feedback and suggestions

Table of Contents

• Getting Started
• News and Updates
• Why Use PR-Agent?
• Features
• See It in Action
• Try It Now
• Qodo Merge 💎
• How It Works
• Data Privacy
• Contributing
• Links

Getting Started

Try it Instantly

Test PR-Agent on any public GitHub repository by commenting @CodiumAI-Agent /improve

GitHub Action

Add automated PR reviews to your repository with a simple workflow file using GitHub Action setup guide

Other Platforms

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

CLI Usage

Run PR-Agent locally on your repository via command line: Local CLI setup guide

Qodo Merge as post-commit in your local IDE

See here

Discover Qodo Merge 💎

Zero-setup hosted solution with advanced features and priority support

• FREE for Open Source: Full features, zero cost for public repos
• Intro and Installation guide
• Plans & Pricing

Qodo Merge as a Post-commit in Your Local IDE

You can receive automatic feedback from Qodo Merge on your local IDE after each commit

News and Updates

Aug 8, 2025

Added full support for GPT-5 models. View the benchmark results for details on the performance of GPT-5 models in PR-Agent.

Jul 1, 2025

You can now receive automatic feedback from Qodo Merge in your local IDE after each commit. Read more about it here.

Jun 21, 2025

v0.30 was released

Jun 3, 2025

Qodo Merge now offers a simplified free tier 💎. Organizations can use Qodo Merge at no cost, with a monthly limit of 75 PR reviews per organization.

Apr 30, 2025

A new feature is now available in the /improve tool for Qodo Merge 💎 - Chat on code suggestions.

Read more about it here.

Apr 16, 2025

New tool for Qodo Merge 💎 - /scan_repo_discussions.

Read more about it here.

Why Use PR-Agent?

A reasonable question that can be asked is: "Why use PR-Agent? What makes it stand out from existing tools?"

Here are some advantages of PR-Agent:

• We emphasize real-life practical usage. Each tool (review, improve, ask, ...) has a single LLM call, no more. We feel that this is critical for realistic team usage - obtaining an answer quickly (~30 seconds) and affordably.
• Our PR Compression strategy is a core ability that enables to effectively tackle both short and long PRs.
• Our JSON prompting strategy enables us to have modular, customizable tools. For example, the '/review' tool categories can be controlled via the configuration file. Adding additional categories is easy and accessible.
• We support multiple git providers (GitHub, GitLab, BitBucket), multiple ways to use the tool (CLI, GitHub Action, GitHub App, Docker, ...), and multiple models (GPT, Claude, Deepseek, ...)

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 a hosted version of PR-Agent, provided by Qodo. It is available for a monthly fee, and provides the following benefits:

1. Fully managed - We take care of everything for you - hosting, models, regular updates, and more. Installation is as simple as signing up and adding the Qodo Merge app to your GitHub/GitLab/BitBucket repo.
2. Improved privacy - No data will be stored or used to train models. Qodo Merge will employ zero data retention, and will use an OpenAI account with zero data retention.
3. Improved support - Qodo Merge users will receive priority support, and will be able to request new features and capabilities.
4. Extra features - In addition to the benefits listed above, Qodo Merge will emphasize more customization, and the usage of static code analysis, in addition to LLM logic, to improve results. See here for a list of features available in Qodo Merge.

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]