PR Agent

What's Changed

• ci(mosaico): detect drift between docker/mosaico and the GitLab mirror by @ofir-frd in #2559
• Add newly released Claude Opus 5 model support by @PeterDaveHello in #2553

🚀 Features

• feat(mosaico): make docker/mosaico a self-contained deployment bundle by @ofir-frd in #2556

🐛 Bug Fixes

• fix(mosaico): report tool failures as FAILED, not empty success by @ofir-frd in #2563
• fix(mosaico): repair two dead checks in the deployment bundle by @ofir-frd in #2562
• fix(mosaico): route on the latest user turn of a forwarded conversation by @ofir-frd in #2561
• fix(mosaico): pin pydantic-settings so Langfuse tracing actually loads by @ofir-frd in #2560
• fix(mosaico): fail fast when mktemp cannot create the scratch dir by @ofir-frd in #2557

📚 Documentation

• docs(installation): document release and image tag immutability by @naorpeled in #2552

🧹 Maintenance

• chore(litellm): trim the callback-drain comments by @naorpeled in #2554

Full Changelog: https://github.com/The-PR-Agent/pr-agent/compare/v0.40.0...v0.41.0

<br />

<div align="center">

<picture>

<source media="(prefers-color-scheme: dark)" srcset="https://codium.ai/images/pr_agent/logo-dark.png" width="330">

<source media="(prefers-color-scheme: light)" srcset="https://codium.ai/images/pr_agent/logo-light.png" width="330">

<img src="https://codium.ai/images/pr_agent/logo-light.png" alt="logo" width="330">

</picture>

<br>

The Original Open-Source PR Reviewer

<br><br>

<a href="https://github.com/the-pr-agent/pr-agent/commits/main">

<img alt="GitHub" src="https://img.shields.io/github/last-commit/the-pr-agent/pr-agent/main?style=for-the-badge" height="20">

</a>

</div>

---

This repository contains the open-source PR Agent Project.

It is not the Qodo free tier.

PR-Agent is an open-source, AI-powered code review agent and a community-maintained legacy project of Qodo. It is distinct from Qodo’s primary AI code review offering, which provides a feature-rich, context-aware experience. Qodo now offers a free tier that integrates seamlessly with GitHub, GitLab, Bitbucket, and Azure DevOps for high-quality automated reviews.

Sponsors

PR-Agent is a community-maintained open-source project, with its ongoing development supported by our sponsors. If you'd like to support the project, consider becoming a sponsor.

<p align="center">

<h3 align="center">🥇 Gold Sponsor</h3>

</p>

<p align="center">

<a target="_blank" href="https://www.qodo.ai/">

<img alt="Qodo — Gold sponsor" src="https://www.qodo.ai/wp-content/uploads/2025/03/qodo-logo.svg" width="300">

</a>

</p>

<p align="center">

<a target="_blank" href="https://www.qodo.ai/get-started/">Try the free version of Qodo</a>

</p>

Table of Contents

• Getting Started
• Why Use PR-Agent?
• Features
• See It in Action
• How It Works
• Data Privacy
• Contributing

Getting Started

[!NOTE]

Docker Hub namespace migration. Releases 0.34.2 and later are published under pragent/pr-agent. Older releases (up to and including v0.31) remain available at the legacy codiumai/pr-agent namespace as a frozen archive — no new images are pushed there. Update any pinned image: / docker pull / uses: docker:// references when upgrading to 0.34.2+.

🚀 Quick Start for PR-Agent

1. GitHub Action (Recommended)

Add automated PR reviews to your repository with a simple workflow file:

# .github/workflows/pr-agent.yml
name: PR Agent
on:
  pull_request:
    types: [opened, synchronize]
jobs:
  pr_agent_job:
    runs-on: ubuntu-latest
    steps:
    - name: PR Agent action step
      uses: the-pr-agent/pr-agent@main
      env:
        OPENAI_KEY: ${{ secrets.OPENAI_KEY }}
        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Full GitHub Action setup guide

2. CLI Usage (Local Development)

Run PR-Agent locally on your repository:

pip install pr-agent
export OPENAI_KEY=your_key_here
pr-agent --pr_url https://github.com/owner/repo/pull/123 review

Complete CLI setup guide

3. Other Platforms

• GitLab webhook setup
• BitBucket app installation
• Azure DevOps setup

[//]: # (## News and Updates)

[//]: # ()

[//]: # (## Aug 8, 2025)

[//]: # ()

[//]: # ()

[//]: # ()

[//]: # (## Jul 1, 2025)

[//]: # (You can now receive automatic feedback from Qodo Merge in your local IDE after each commit. Read more about it [here]&#40;https://github.com/qodo-ai/agents/tree/main/agents/qodo-merge-post-commit&#41;.)

[//]: # ()

[//]: # ()

[//]: # (## Jun 21, 2025)

[//]: # ()

[//]: # (v0.30 was [released]&#40;https://github.com/the-pr-agent/pr-agent/releases&#41;)

[//]: # ()

[//]: # ()

[//]: # (## Apr 30, 2025)

[//]: # ()

[//]: # (A new feature is now available in the /improve tool for Qodo Merge 💎 - Chat on code suggestions.)

[//]: # ()

[//]: # (<img width="512" alt="image" src="https://codium.ai/images/pr_agent/improve_chat_on_code_suggestions_ask.png" />)

[//]: # ()

[//]: # (Read more about it [here]&#40;https://docs.pr-agent.ai/tools/improve/#chat-on-code-suggestions&#41;.)

[//]: # ()

[//]: # ()

Why Use PR-Agent?

🎯 Built for Real Development Teams

Fast & Affordable: Each tool (/review, /improve, /ask) uses a single LLM call (~30 seconds, low cost)

Handles Any PR Size: Our PR Compression strategy effectively processes both small and large PRs

Highly Customizable: JSON-based prompting allows easy customization of review categories and behavior via configuration files

Platform Agnostic:

• Git Providers: GitHub, GitLab, BitBucket, Azure DevOps, Gitea
• Deployment: CLI, GitHub Actions, Docker, self-hosted, webhooks
• AI Models: OpenAI GPT, Claude, Deepseek, and more

Open Source Benefits:

• Full control over your data and infrastructure
• Customize prompts and behavior for your team's needs
• No vendor lock-in
• Community-driven development

Features

<div style="text-align:left;">

PR-Agent offers comprehensive pull request functionalities integrated with various git providers:

| | | GitHub | GitLab | Bitbucket | Azure DevOps | Gitea |

|---------------------------------------------------------|----------------------------------------------------------------------------------------|:------:|:------:|:---------:|:------------:|:-----:|

| TOOLS | Describe | ✅ | ✅ | ✅ | ✅ | ✅ |

| | Review | ✅ | ✅ | ✅ | ✅ | ✅ |

| | Improve | ✅ | ✅ | ✅ | ✅ | ✅ |

| | Ask | ✅ | ✅ | ✅ | ✅ | |

| | ⮑ Ask on code lines | ✅ | ✅ | | | |

| | Help Docs | ✅ | ✅ | ✅ | | |

| | Update CHANGELOG | ✅ | ✅ | ✅ | ✅ | |

| | | | | | | |

| USAGE | CLI | ✅ | ✅ | ✅ | ✅ | ✅ |

| | App / webhook | ✅ | ✅ | ✅ | ✅ | ✅ |

| | Tagging bot | ✅ | | | | |

| | Actions | ✅ | ✅ | ✅ | ✅ | |

| | | | | | | |

| CORE | Adaptive and token-aware file patch fitting | ✅ | ✅ | ✅ | ✅ | |

| | Dynamic context | ✅ | ✅ | ✅ | ✅ | |

| | Fetching ticket context | ✅ | ✅ | ✅ | | |

| | Interactivity | ✅ | ✅ | | | |

| | Local and global metadata | ✅ | ✅ | ✅ | ✅ | |

| | Multiple models support | ✅ | ✅ | ✅ | ✅ | |

| | PR compression | ✅ | ✅ | ✅ | ✅ | |

| | Self reflection | ✅ | ✅ | ✅ | ✅ | |

[//]: # (- Support for additional git providers is described in [here]&#40;./docs/Full_environments.md&#41;)

---

See It in Action

</div>

<h4><a href="https://github.com/the-pr-agent/pr-agent/pull/530">/describe</a></h4>

<div align="center">

<p float="center">

<img src="https://www.codium.ai/images/pr_agent/describe_new_short_main.png" width="512">

</p>

</div>

<hr>

<h4><a href="https://github.com/the-pr-agent/pr-agent/pull/732#issuecomment-1975099151">/review</a></h4>

<div align="center">

<p float="center">

<kbd>

<img src="https://www.codium.ai/images/pr_agent/review_new_short_main.png" width="512">

</kbd>

</p>

</div>

<hr>

<h4><a href="https://github.com/the-pr-agent/pr-agent/pull/732#issuecomment-1975099159">/improve</a></h4>

<div align="center">

<p float="center">

<kbd>

<img src="https://www.codium.ai/images/pr_agent/improve_new_short_main.png" width="512">

</kbd>

</p>

</div>

<hr>

Usage Examples

PR-Agent tools run as a comment on a PR or from the CLI. A few common ones:

# Comment on a PR (GitHub/GitLab/Bitbucket/…):
/describe                        # generate title, summary, walkthrough and labels
/review                          # findings, security, review effort and tests
/improve                         # actionable code-improvement suggestions
/ask "What does this PR change?" # free-text Q&A about the PR

# Or locally via the CLI:
pr-agent --pr_url <PR_URL> review

See the Tools docs for the full list of tools with example commands, and each tool's page for screenshots and options.

<hr>

How It Works

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

PR-Agent Tools

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

Contributing

To contribute to the project, get started by reading our Contributing Guide.

Big News for PR-Agent

PR-Agent has a new home!

After years of building this tool alongside the community, Qodo has donated PR-Agent to the open-source community - and we couldn't be more excited about what comes next.

The project now lives in the PR-Agent org on GitHub, is fully community-owned, and is open for contributions and additional maintainers.

What else changed:

• Docs moved to - www.pr-agent.ai
• Qodo Merge (Qodo 1.0), the hosted URL, which was the enterprise version of PR-Agent, has been rebranded and evolved into Qodo (Qodo 2.0), a full AI code review platform.

❤️ Community

This open-source release remains here as a community contribution from Qodo — the origin of modern AI-powered code collaboration. We’re proud to share it and inspire developers worldwide.

The project now has its first external maintainer, Naor (@naorpeled), and is currently in the process of being donated to an open-source foundation.