🚀CodiumAI PR-Agent: An AI-Powered 🤖 Tool for Automated Pull Request Analysis, Feedback, Suggestions and More! 💻🔍
See the Installation Guide for instructions on installing PR-Agent on different platforms.
See the Usage Guide for instructions on running PR-Agent tools via different interfaces, such as CLI, PR Comments, or by automatically triggering them when a new PR is opened.
See the Tools Guide for a detailed description of the different tools, and the available configurations for each tool.
You can now ask questions about images that appear in the comment, where the entire PR is considered as the context. see here for more details.
PR-Agent is now available for easy installation via pip.
require_can_be_split_review
.
If set to true, the tool will add a section that checks if the PR contains several themes, and can be split into smaller PRs.
(click on the image to see an instructional video)
Supported commands per platform:
GitHub | Gitlab | Bitbucket | Azure DevOps | ||
---|---|---|---|---|---|
TOOLS | Review | ✅ | ✅ | ✅ | ✅ |
⮑ Incremental | ✅ | ||||
⮑ SOC2 Compliance 💎 | ✅ | ✅ | ✅ | ✅ | |
Describe | ✅ | ✅ | ✅ | ✅ | |
⮑ Inline File Summary 💎 | ✅ | ||||
Improve | ✅ | ✅ | ✅ | ✅ | |
⮑ Extended | ✅ | ✅ | ✅ | ✅ | |
Ask | ✅ | ✅ | ✅ | ✅ | |
⮑ Ask on code lines | ✅ | ✅ | |||
Custom Suggestions 💎 | ✅ | ✅ | ✅ | ✅ | |
Test 💎 | ✅ | ✅ | ✅ | ||
Reflect and Review | ✅ | ✅ | ✅ | ✅ | |
Update CHANGELOG.md | ✅ | ✅ | ✅ | ✅ | |
Find Similar Issue | ✅ | ||||
Add PR Documentation 💎 | ✅ | ✅ | ✅ | ||
Custom Labels 💎 | ✅ | ✅ | ✅ | ||
Analyze 💎 | ✅ | ✅ | ✅ | ||
CI Feedback 💎 | ✅ | ||||
Similar Code 💎 | ✅ | ||||
USAGE | CLI | ✅ | ✅ | ✅ | ✅ |
App / webhook | ✅ | ✅ | ✅ | ✅ | |
Tagging bot | ✅ | ||||
Actions | ✅ | ✅ | |||
CORE | PR compression | ✅ | ✅ | ✅ | ✅ |
Repo language prioritization | ✅ | ✅ | ✅ | ✅ | |
Adaptive and token-aware file patch fitting | ✅ | ✅ | ✅ | ✅ | |
Multiple models support | ✅ | ✅ | ✅ | ✅ | |
Static code analysis 💎 | ✅ | ✅ | ✅ | ✅ | |
Global and wiki configurations 💎 | ✅ | ✅ | ✅ | ✅ | |
PR interactive actions 💎 | ✅ |
‣ 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.
‣ Custom Suggestions 💎 (/custom_suggestions
): 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.
Try the GPT-4 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
To set up your own PR-Agent, see the Installation section below.
Note that when you set your own PR-Agent or use CodiumAI hosted PR-Agent, there is no need to mention @CodiumAI-Agent ...
. Instead, directly start with the command, e.g., /ask ...
.
PR-Agent Pro is a hosted version of PR-Agent, provided by CodiumAI. It is available for a monthly fee, and provides the following benefits:
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
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:
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
When using PR-Agent Pro 💎, hosted by CodiumAI, 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.