Skip to content

๐Ÿš€CodiumAI PR-Agent: An AI-Powered ๐Ÿค– Tool for Automated Pull Request Analysis, Feedback, Suggestions and More! ๐Ÿ’ป๐Ÿ”

License

Notifications You must be signed in to change notification settings

cloudlinux/pr-agent

ย 
ย 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation


Making pull requests less painful with an AI agent

GitHub license Discord GitHub

CodiumAI PR-Agent is an open-source tool aiming to help developers review pull requests faster and more efficiently. It automatically analyzes the pull request and can provide several types of PR feedback:

Auto Description (/describe): Automatically generating PR description - title, type, summary, code walkthrough and labels.
Auto Review (/review): Adjustable feedback about the PR main theme, type, relevant tests, security issues, score, and various suggestions for the PR content.
Question Answering (/ask ...): Answering free-text questions about the PR.
Code Suggestions (/improve): Committable code suggestions for improving the PR.
Update Changelog (/update_changelog): Automatically updating the CHANGELOG.md file with the PR changes.

See the usage guide for instructions how to run the different tools from CLI, or by online usage.

Example results:

Overview

PR-Agent offers extensive pull request functionalities across various git providers:

GitHub Gitlab Bitbucket CodeCommit Azure DevOps Gerrit
TOOLS Review โœ… โœ… โœ… โœ… โœ… โœ…
Ask โœ… โœ… โœ… โœ… โœ… โœ…
Auto-Description โœ… โœ… โœ… โœ… โœ…
Improve Code โœ… โœ… โœ… โœ…
โฎ‘ Extended โœ… โœ… โœ… โœ…
Reflect and Review โœ… โœ… โœ…
Update CHANGELOG.md โœ…
USAGE CLI โœ… โœ… โœ… โœ… โœ…
App / webhook โœ… โœ…
Tagging bot โœ…
Actions โœ…
Web server โœ…
CORE PR compression โœ… โœ… โœ… โœ… โœ… โœ…
Repo language prioritization โœ… โœ… โœ… โœ… โœ… โœ…
Adaptive and token-aware
file patch fitting
โœ… โœ… โœ… โœ… โœ… โœ…
Multiple models support โœ… โœ… โœ… โœ… โœ… โœ…
Incremental PR Review โœ…

Review the usage guide section for detailed instructions how to use the different tools, select the relevant git provider (GitHub, Gitlab, Bitbucket,...), and adjust the configuration file to your needs.

Try it now

You can try GPT-4 powered PR-Agent, on your public GitHub repository, instantly. 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

Review generation process

To set up your own PR-Agent, see the Installation section below.


Installation

To get started with PR-Agent quickly, you first need to acquire two tokens:

  1. An OpenAI key from here, with access to GPT-4.
  2. A GitHub personal access token (classic) with the repo scope.

There are several ways to use PR-Agent:

How it works

The following diagram illustrates PR-Agent tools and their flow:

PR-Agent Tools

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 make 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 GPT-4 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, CodeCommit), multiple ways to use the tool (CLI, GitHub Action, GitHub App, Docker, ...), and multiple models (GPT-4, GPT-3.5, Anthropic, Cohere, Llama2).
  • We are open-source, and welcome contributions from the community.

Roadmap

  • Support additional models, as a replacement for OpenAI (see here)
  • Develop additional logic for handling large PRs (see here)
  • Add additional context to the prompt. For example, repo (or relevant files) summarization, with tools such a ctags
  • PR-Agent for issues, and just for pull requests
  • Adding more tools. Possible directions:
    • PR description
    • Inline code suggestions
    • Reflect and review
    • Rank the PR (see here)
    • Enforcing CONTRIBUTING.md guidelines
    • Performance (are there any performance issues)
    • Documentation (is the PR properly documented)
    • ...

Similar Projects

About

๐Ÿš€CodiumAI PR-Agent: An AI-Powered ๐Ÿค– Tool for Automated Pull Request Analysis, Feedback, Suggestions and More! ๐Ÿ’ป๐Ÿ”

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 99.8%
  • Other 0.2%