Overview¶
CodiumAI PR-Agent is an open-source tool to help efficiently review and handle pull requests.
-
See the Installation Guide for instructions on installing and running the tool on different git platforms.
-
See the Usage Guide for instructions on running the PR-Agent commands via different interfaces, including CLI, online usage, or by automatically triggering them when a new PR is opened.
-
See the Tools Guide for a detailed description of the different tools.
PR-Agent Features¶
PR-Agent offers extensive pull request functionalities across various git providers.
GitHub | Gitlab | Bitbucket | Azure DevOps | ||
---|---|---|---|---|---|
TOOLS | Review | โ | โ | โ | โ |
โฎ Incremental | โ | ||||
โฎ SOC2 Compliance ๐ | โ | โ | โ | โ | |
Ask | โ | โ | โ | โ | |
Describe | โ | โ | โ | โ | |
โฎ Inline file summary ๐ | โ | โ | โ | ||
Improve | โ | โ | โ | โ | |
โฎ Extended | โ | โ | โ | โ | |
Custom Prompt ๐ | โ | โ | โ | โ | |
Reflect and Review | โ | โ | โ | โ | |
Update CHANGELOG.md | โ | โ | โ | ๏ธ | |
Find Similar Issue | โ | ๏ธ | |||
Add PR Documentation ๐ | โ | โ | โ | ||
Generate Custom Labels ๐ | โ | โ | โ | ||
Analyze PR Components ๐ | โ | โ | โ | ||
๏ธ | |||||
USAGE | CLI | โ | โ | โ | โ |
App / webhook | โ | โ | โ | โ | |
Actions | โ | ๏ธ | |||
CORE | PR compression | โ | โ | โ | โ |
Repo language prioritization | โ | โ | โ | โ | |
Adaptive and token-aware file patch fitting | โ | โ | โ | โ | |
Multiple models support | โ | โ | โ | โ | |
Incremental PR review | โ | ||||
Static code analysis ๐ | โ | โ | โ | โ | |
Multiple configuration options ๐ | โ | โ | โ | โ |
๐ marks a feature available only in PR-Agent Pro
Example Results¶
/describe¶
/review¶
/improve¶
/generate_labels¶
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
PR-Agent Pro ๐¶
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:
- 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 PR-Agent app to your GitHub\GitLab\BitBucket repo.
- Improved privacy - No data will be stored or used to train models. PR-Agent Pro will employ zero data retention, and will use an OpenAI account with zero data retention.
- Improved support - PR-Agent Pro users will receive priority support, and will be able to request new features and capabilities.
- Extra features -In addition to the benefits listed above, PR-Agent Pro will emphasize more customization, and the usage of static code analysis, in addition to LLM logic, to improve results. It has the following additional tools and features:
- (Tool): Analyze PR components
- (Tool): Custom Prompt Suggestions
- (Tool): Tests
- (Tool): PR documentation
- (Tool): Improve Component
- (Tool): Similar code search
- (Tool): CI feedback
- (Feature): Interactive triggering
- (Feature): SOC2 compliance check
- (Feature): Custom labels
- (Feature): Global and wiki configuration
- (Feature): Inline file summary
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
CodiumAI-hosted PR-Agent Pro ๐¶
-
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.
-
For certain clients, CodiumAI-hosted PR-Agent Pro will use CodiumAIโs proprietary models โ if this is the case, you will be notified.
-
No passive collection of Code and Pull Requestsโ data โ PR-Agent 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.
PR-Agent Chrome extension¶
- The PR-Agent 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 PR-Agent.