PR-Agent: Open-source AI agent for pull request review

PR-Agent is an open-source AI agent for describing, reviewing, improving, and answering questions about pull requests. It runs from PR comments, webhooks, CI, or the terminal across major Git providers.

Overview

PR-Agent is a community-maintained, open-source AI-powered code review agent. It automates pull request descriptions, reviews, improvements, and free-text Q&A, and can be invoked through PR comments, webhooks, CI, or the terminal. It supports GitHub, GitLab, Bitbucket, Azure DevOps, and Gitea.

Key Features

Describes, reviews, and improves pull requests through commands such as /describe, /review, and /improve.
Answers free-text questions about a pull request with /ask and supports issue-scoped similar issue discovery with /similar_issue.
Works with GitHub, GitLab, Bitbucket, Azure DevOps, and Gitea.
Runs from PR comments, webhooks, GitHub Actions, Docker, self-hosted deployment, or the CLI.
Supports multiple AI models through LiteLLM, including OpenAI GPT, Anthropic Claude, Google Gemini, DeepSeek, and Mistral.
Uses a PR Compression strategy for small and large PRs and allows JSON-based prompt customization.

Use Cases

Automate first-pass pull request reviews and reviewer guidance.
Generate or update pull request descriptions.
Suggest code improvements from a PR comment or the command line.
Answer questions about a pull request and find similar issues.

Getting Started

For GitHub, add a workflow that uses the-pr-agent/pr-agent@main with OPENAI_KEY and GITHUB_TOKEN secrets.
For local CLI use, install pr-agent[github], set OPENAI_KEY, and run pr-agent with --pr_url and the pull request URL, followed by review.
For a Docker quick start, run pragent/pr-agent:latest with OPENAI__KEY and GITHUB__USER_TOKEN.

Deployment & Requirements

A terminal or Docker quick start requires an OpenAI key and a GitHub token.
Git provider SDKs are optional extras; install the one for your provider or pr-agent[all] for all integrations.
Docker releases 0.34.2 and later are published under pragent/pr-agent.

Before You Adopt

License: MIT. Review its terms before using, modifying, or distributing the project.
The project describes itself as a community-maintained legacy project of Qodo, separate from Qodo's primary AI code review offering.
Older releases remain available in the legacy codiumai/pr-agent namespace as a frozen archive, and no new images are pushed there.
/help_docs is temporarily disabled since v0.36.1 pending a fix for a credential-exposure issue.
When self-hosting with an OpenAI API key, data handling is between the user and OpenAI.

PR-Agent