🚀 PR-Agent (Qodo Merge open-source): An AI-Powered 🤖 Tool for Automated Pull Request Analysis, Feedback, Suggestions and More! 💻🔍
pip install pr-agent
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
News and Updates
Feb 28, 2025
A new version, v0.27, was released. See release notes here.
Feb 27, 2025
- Updated the default model to
o3-minifor all tools. You can still use thegpt-4oas the default model by setting themodelparameter in the configuration file. - Important updates and bug fixes for Azure DevOps, see here
- Added support for adjusting the response language of the PR-Agent tools.
Feb 6, 2025
New design for the /improve tool:
Jan 25, 2025
The open-source GitHub organization was updated:
https://github.com/codium-ai/pr-agent →
https://github.com/qodo-ai/pr-agent
The docker should be redirected automatically to the new location.
However, if you have any issues, please update the GitHub action docker image from
uses: Codium-ai/pr-agent@main
to
uses: qodo-ai/pr-agent@main
Jan 2, 2025
New tool /Implement (💎), which converts human code review discussions and feedback into ready-to-commit code changes.
December 30, 2024
Following feedback from the community, we have addressed two vulnerabilities identified in the open-source PR-Agent project. The fixes are now included in the newly released version (v0.26), available as of today.
Overview
Supported commands per platform:
| GitHub | GitLab | Bitbucket | Azure DevOps | ||
|---|---|---|---|---|---|
| TOOLS | Review | ✅ | ✅ | ✅ | ✅ |
| Describe | ✅ | ✅ | ✅ | ✅ | |
| Improve | ✅ | ✅ | ✅ | ✅ | |
| Ask | ✅ | ✅ | ✅ | ✅ | |
| ⮑ Ask on code lines | ✅ | ✅ | |||
| Update CHANGELOG | ✅ | ✅ | ✅ | ✅ | |
| Ticket Context 💎 | ✅ | ✅ | ✅ | ||
| Utilizing Best Practices 💎 | ✅ | ✅ | ✅ | ||
| PR Chat 💎 | ✅ | ||||
| Suggestion Tracking 💎 | ✅ | ✅ | |||
| CI Feedback 💎 | ✅ | ||||
| PR Documentation 💎 | ✅ | ✅ | |||
| Custom Labels 💎 | ✅ | ✅ | |||
| Analyze 💎 | ✅ | ✅ | |||
| Similar Code 💎 | ✅ | ||||
| Custom Prompt 💎 | ✅ | ✅ | ✅ | ||
| Test 💎 | ✅ | ✅ | |||
| Implement 💎 | ✅ | ✅ | ✅ | ||
| Auto-Approve 💎 | ✅ | ✅ | ✅ | ||
| USAGE | CLI | ✅ | ✅ | ✅ | ✅ |
| App / webhook | ✅ | ✅ | ✅ | ✅ | |
| Tagging bot | ✅ | ||||
| Actions | ✅ | ✅ | ✅ | ✅ | |
| CORE | PR compression | ✅ | ✅ | ✅ | ✅ |
| Adaptive and token-aware file patch fitting | ✅ | ✅ | ✅ | ✅ | |
| Multiple models support | ✅ | ✅ | ✅ | ✅ | |
| Local and global metadata | ✅ | ✅ | ✅ | ✅ | |
| Dynamic context | ✅ | ✅ | ✅ | ✅ | |
| Self reflection | ✅ | ✅ | ✅ | ✅ | |
| Static code analysis 💎 | ✅ | ✅ | |||
| Global and wiki configurations 💎 | ✅ | ✅ | ✅ | ||
| PR interactive actions 💎 | ✅ | ✅ | |||
| Impact Evaluation 💎 | ✅ | ✅ |
- 💎 means this feature is available only in Qodo-Merge
‣ Auto Description (/describe): Automatically generating PR description - title, type, summary, code walkthrough and labels.
‣ Auto Review (/review): Adjustable feedback about the PR, possible issues, security concerns, review effort and more.
‣ Code Suggestions (/improve): Code suggestions for improving the PR.
‣ Question Answering (/ask ...): Answering free-text questions about the PR.
‣ Update Changelog (/update_changelog): Automatically updating the CHANGELOG.md file with the PR changes.
‣ Find Similar Issue (/similar_issue): Automatically retrieves and presents similar issues.
‣ Add Documentation 💎 (/add_docs): Generates documentation to methods/functions/classes that changed in the PR.
‣ Generate Custom Labels 💎 (/generate_labels): Generates custom labels for the PR, based on specific guidelines defined by the user.
‣ Analyze 💎 (/analyze): Identify code components that changed in the PR, and enables to interactively generate tests, docs, and code suggestions for each component.
‣ Test 💎 (/test): Generate tests for a selected component, based on the PR code changes.
‣ Custom Prompt 💎 (/custom_prompt): Automatically generates custom suggestions for improving the PR code, based on specific guidelines defined by the user.
‣ Generate Tests 💎 (/test component_name): Generates unit tests for a selected component, based on the PR code changes.
‣ CI Feedback 💎 (/checks ci_job): Automatically generates feedback and analysis for a failed CI job.
‣ Similar Code 💎 (/find_similar_component): Retrieves the most similar code components from inside the organization's codebase, or from open-source code.
‣ Implement 💎 (/implement): Generates implementation code from review suggestions.
Example results
/describe
/review
/improve
Try it now
Try the Claude Sonnet 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:
- 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.
- 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.
- Improved support - Qodo Merge users will receive priority support, and will be able to request new features and capabilities.
- 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
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 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, ...)
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.
Links
- Discord community: https://discord.gg/kG35uSHDBc
- 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