From 7ee5d33bed3c07aa99fab144c0cda5c3c89a2204 Mon Sep 17 00:00:00 2001 From: Itamar Friedman Date: Tue, 26 Aug 2025 16:22:13 -0400 Subject: [PATCH 1/4] docs: clarify differences between PR-Agent and Qodo Merge in README - Added clear header explaining PR-Agent is open source, Qodo Merge is hosted - Created comparison table showing setup time and costs upfront - Added dedicated "PR-Agent vs Qodo Merge" section with detailed comparison - Restructured "Getting Started" to focus on PR-Agent with code examples - Enhanced "Why Use PR-Agent?" to emphasize open source benefits - Updated Qodo Merge section to be factual rather than sales-focused - Made the README more developer-friendly and less confusing for newcomers --- .gitignore | 3 +- README.md | 162 ++++++++++++++++++++++++++++++++++++++++++++--------- 2 files changed, 136 insertions(+), 29 deletions(-) diff --git a/.gitignore b/.gitignore index 8da05107fd..38ecae7395 100644 --- a/.gitignore +++ b/.gitignore @@ -4,6 +4,7 @@ .env .venv/ venv/ +venv-pr-agent/ pr_agent/settings/.secrets.toml __pycache__ dist/ @@ -12,4 +13,4 @@ build/ .DS_Store docs/.cache/ .qodo -poetry.lock +poetry.lock \ No newline at end of file diff --git a/README.md b/README.md index e7a9d05041..fcf3c6bb07 100644 --- a/README.md +++ b/README.md @@ -15,7 +15,20 @@ [Tools Guide](https://qodo-merge-docs.qodo.ai/tools/) | [Qodo Merge](https://qodo-merge-docs.qodo.ai/overview/pr_agent_pro/) 💎 -PR-Agent aims to help efficiently review and handle pull requests, by providing AI feedback and suggestions +## Open-Source AI-Powered Code Review Tool + +**PR-Agent** is a free, open-source tool that provides AI-powered code review and PR assistance. Run it locally, on your CI/CD, or self-host it. + +**[Qodo Merge](https://qodo-merge-docs.qodo.ai/overview/pr_agent_pro/) 💎** is the hosted, enterprise version with additional features, zero-setup, and priority support. + +--- + +### Quick Start Options + +| **Option** | **Best For** | **Setup Time** | **Cost** | +|------------|--------------|----------------|----------| +| **PR-Agent (Open Source)** | Developers who want full control, self-hosting, or custom integrations | 5-15 minutes | Free | +| **Qodo Merge** | Teams wanting zero-setup, advanced features, and enterprise support | 2 minutes | Free tier available | [![Static Badge](https://img.shields.io/badge/Chrome-Extension-violet)](https://chromewebstore.google.com/detail/qodo-merge-ai-powered-cod/ephlnjeghhogofkifjloamocljapahnl) @@ -29,6 +42,7 @@ PR-Agent aims to help efficiently review and handle pull requests, by providing ## Table of Contents +- [PR-Agent vs Qodo Merge](#pr-agent-vs-qodo-merge) - [Getting Started](#getting-started) - [News and Updates](#news-and-updates) - [Why Use PR-Agent?](#why-use-pr-agent) @@ -41,33 +55,95 @@ PR-Agent aims to help efficiently review and handle pull requests, by providing - [Contributing](#contributing) - [Links](#links) +## PR-Agent vs Qodo Merge + +### PR-Agent (This Repository) - Open Source + +✅ **What you get:** +- Complete source code access and customization +- Self-hosted deployment options +- All core AI review tools (`/describe`, `/review`, `/improve`, `/ask`) +- Support for GitHub, GitLab, BitBucket, Azure DevOps +- CLI usage for local development +- Free forever + +⚙️ **What you need to manage:** +- Your own API keys (OpenAI, Claude, etc.) +- Infrastructure and hosting +- Updates and maintenance +- Configuration management + +### Qodo Merge - Hosted Solution + +✅ **What you get (everything above plus):** +- Zero-setup installation (2-minute GitHub app install) +- Managed infrastructure and automatic updates +- Advanced features: CI feedback, code suggestions tracking, custom prompts +- Priority support and feature requests +- Enhanced privacy with zero data retention +- Free tier: 75 PR reviews/month per organization + +💰 **Pricing:** +- Free tier available +- Paid plans for unlimited usage +- [View pricing details](https://www.qodo.ai/pricing/) + +**👨‍💻 Developer Recommendation:** Start with PR-Agent if you want to experiment, customize heavily, or have specific self-hosting requirements. Choose Qodo Merge if you want to focus on coding rather than tool maintenance. + ## Getting Started -### Try it Instantly +### 🚀 Quick Start for PR-Agent (Open Source) + +#### 1. Try it Instantly (No Setup) Test PR-Agent on any public GitHub repository by commenting `@CodiumAI-Agent /improve` -### GitHub Action -Add automated PR reviews to your repository with a simple workflow file using [GitHub Action setup guide](https://qodo-merge-docs.qodo.ai/installation/github/#run-as-a-github-action) +#### 2. GitHub Action (Recommended) +Add automated PR reviews to your repository with a simple workflow file: +```yaml +# .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: Codium-ai/pr-agent@main + env: + OPENAI_KEY: ${{ secrets.OPENAI_KEY }} + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} +``` +[Full GitHub Action setup guide](https://qodo-merge-docs.qodo.ai/installation/github/#run-as-a-github-action) + +#### 3. CLI Usage (Local Development) +Run PR-Agent locally on your repository: +```bash +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](https://qodo-merge-docs.qodo.ai/usage-guide/automations_and_usage/#local-repo-cli) -#### Other Platforms +#### 4. Other Platforms - [GitLab webhook setup](https://qodo-merge-docs.qodo.ai/installation/gitlab/) - [BitBucket app installation](https://qodo-merge-docs.qodo.ai/installation/bitbucket/) - [Azure DevOps setup](https://qodo-merge-docs.qodo.ai/installation/azure/) -### CLI Usage -Run PR-Agent locally on your repository via command line: [Local CLI setup guide](https://qodo-merge-docs.qodo.ai/usage-guide/automations_and_usage/#local-repo-cli) +### 💎 Want Zero-Setup? Try Qodo Merge -### Qodo Merge as post-commit in your local IDE -See [here](https://github.com/qodo-ai/agents/tree/main/agents/qodo-merge-post-commit) +If you prefer a hosted solution without managing infrastructure: -### Discover Qodo Merge 💎 -Zero-setup hosted solution with advanced features and priority support -- **[FREE for Open Source](https://github.com/marketplace/qodo-merge-pro-for-open-source)**: Full features, zero cost for public repos -- [Intro and Installation guide](https://qodo-merge-docs.qodo.ai/installation/qodo_merge/) -- [Plans & Pricing](https://www.qodo.ai/pricing/) +1. **[Install Qodo Merge GitHub App](https://github.com/marketplace/qodo-merge-pro)** (2 minutes) +2. **[FREE for Open Source](https://github.com/marketplace/qodo-merge-pro-for-open-source)**: Full features, zero cost for public repos +3. **Free Tier**: 75 PR reviews/month for private repos +4. **[View Plans & Pricing](https://www.qodo.ai/pricing/)** -### Qodo Merge as a Post-commit in Your Local IDE -You can receive automatic feedback from Qodo Merge on your local IDE after each [commit](https://github.com/qodo-ai/agents/tree/main/agents/qodo-merge-post-commit) +[Complete Qodo Merge setup guide](https://qodo-merge-docs.qodo.ai/installation/qodo_merge/) + +### 💻 Local IDE Integration +Receive automatic feedback in your IDE after each commit: [Qodo Merge post-commit agent](https://github.com/qodo-ai/agents/tree/main/agents/qodo-merge-post-commit) ## News and Updates @@ -120,14 +196,24 @@ Read more about it [here](https://qodo-merge-docs.qodo.ai/tools/scan_repo_discus ## Why Use PR-Agent? -A reasonable question that can be asked is: `"Why use PR-Agent? What makes it stand out from existing tools?"` +### 🎯 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](https://qodo-merge-docs.qodo.ai/core-abilities/#pr-compression-strategy) effectively processes both small and large PRs -Here are some advantages of PR-Agent: +**Highly Customizable**: JSON-based prompting allows easy customization of review categories and behavior via [configuration files](pr_agent/settings/configuration.toml) -- We emphasize **real-life practical usage**. Each tool (review, improve, ask, ...) has a single LLM 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](https://qodo-merge-docs.qodo.ai/core-abilities/#pr-compression-strategy) is a core ability that enables to effectively tackle both short and long PRs. -- Our JSON prompting strategy enables us to have **modular, customizable tools**. For example, the '/review' tool categories can be controlled via the [configuration](pr_agent/settings/configuration.toml) file. Adding additional categories is easy and accessible. -- We support **multiple git providers** (GitHub, GitLab, BitBucket), **multiple ways** to use the tool (CLI, GitHub Action, GitHub App, Docker, ...), and **multiple models** (GPT, Claude, Deepseek, ...) +**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 @@ -240,13 +326,33 @@ It does not have 'edit' access to your repo, for example, so it cannot update th ## Qodo Merge 💎 -[Qodo Merge](https://www.qodo.ai/pricing/) is a hosted version of PR-Agent, provided by Qodo. It is available for a monthly fee, and provides the following benefits: +[Qodo Merge](https://www.qodo.ai/pricing/) is the hosted version of PR-Agent with additional enterprise features. + +### Key Differences from Open Source PR-Agent: + +**Infrastructure & Management:** +- Fully managed hosting and automatic updates +- Zero-setup installation (GitHub/GitLab/BitBucket app) +- No need to manage API keys or infrastructure + +**Enhanced Privacy:** +- Zero data retention policy +- No data used for model training +- Enterprise-grade security + +**Additional Features:** +- Advanced code suggestions with tracking +- CI feedback analysis +- Custom prompts and labels +- Static code analysis integration +- Priority support + +**Pricing:** +- Free tier: 75 PR reviews/month per organization +- Paid plans for unlimited usage +- Free for open source projects -1. **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 Qodo Merge app to your GitHub/GitLab/BitBucket repo. -2. **Improved privacy** - No data will be stored or used to train models. Qodo Merge will employ zero data retention, and will use an OpenAI account with zero data retention. -3. **Improved support** - Qodo Merge users will receive priority support, and will be able to request new features and capabilities. -4. **Extra features** - In addition to the benefits listed above, Qodo Merge will emphasize more customization, and the usage of static code analysis, in addition to LLM logic, to improve results. -See [here](https://qodo-merge-docs.qodo.ai/overview/pr_agent_pro/) for a list of features available in Qodo Merge. +See [complete feature comparison](https://qodo-merge-docs.qodo.ai/overview/pr_agent_pro/) for detailed differences. ## How It Works From ae8b3486b628c1b23b3a4228dd92b0acc1b1f314 Mon Sep 17 00:00:00 2001 From: Itamar Friedman Date: Wed, 27 Aug 2025 08:37:56 -0400 Subject: [PATCH 2/4] revert: undo unintended changes to .gitignore --- .gitignore | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/.gitignore b/.gitignore index 38ecae7395..8da05107fd 100644 --- a/.gitignore +++ b/.gitignore @@ -4,7 +4,6 @@ .env .venv/ venv/ -venv-pr-agent/ pr_agent/settings/.secrets.toml __pycache__ dist/ @@ -13,4 +12,4 @@ build/ .DS_Store docs/.cache/ .qodo -poetry.lock \ No newline at end of file +poetry.lock From bf78a0d33e22a631181e51b88a5c14a27b07e239 Mon Sep 17 00:00:00 2001 From: Itamar Friedman Date: Wed, 27 Aug 2025 10:36:17 -0400 Subject: [PATCH 3/4] docs: clarify Qodo Merge enhances open-source features Updated the comparison table to better explain that Qodo Merge enhances the existing open-source features rather than just adding separate advanced features. This makes it clearer that both versions are sophisticated, with Qodo Merge building upon the open-source foundation. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index fcf3c6bb07..6f87e22999 100644 --- a/README.md +++ b/README.md @@ -28,7 +28,7 @@ | **Option** | **Best For** | **Setup Time** | **Cost** | |------------|--------------|----------------|----------| | **PR-Agent (Open Source)** | Developers who want full control, self-hosting, or custom integrations | 5-15 minutes | Free | -| **Qodo Merge** | Teams wanting zero-setup, advanced features, and enterprise support | 2 minutes | Free tier available | +| **Qodo Merge** | Teams wanting zero-setup, enhancing the open-source features, additional enterprise features, and managed hosting | 2 minutes | Free tier available | [![Static Badge](https://img.shields.io/badge/Chrome-Extension-violet)](https://chromewebstore.google.com/detail/qodo-merge-ai-powered-cod/ephlnjeghhogofkifjloamocljapahnl) From c0b29b1c8d35d4d7ea56854c81c3fcde6c8e1e09 Mon Sep 17 00:00:00 2001 From: Itamar Friedman Date: Wed, 27 Aug 2025 13:50:02 -0400 Subject: [PATCH 4/4] docs: add navigation links and improve section title consistency - Added clickable links in Quick Start Options table to relevant sections - Updated "Want Zero-Setup? Try Qodo Merge" to "Try Qodo Merge (Zero Setup)" - Improved navigation and maintained consistent phrasing between options - Makes it easier for users to jump directly to setup instructions --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 6f87e22999..9364a2c42d 100644 --- a/README.md +++ b/README.md @@ -27,8 +27,8 @@ | **Option** | **Best For** | **Setup Time** | **Cost** | |------------|--------------|----------------|----------| -| **PR-Agent (Open Source)** | Developers who want full control, self-hosting, or custom integrations | 5-15 minutes | Free | -| **Qodo Merge** | Teams wanting zero-setup, enhancing the open-source features, additional enterprise features, and managed hosting | 2 minutes | Free tier available | +| **[PR-Agent (Open Source)](#-quick-start-for-pr-agent-open-source)** | Developers who want full control, self-hosting, or custom integrations | 5-15 minutes | Free | +| **[Qodo Merge](#-try-qodo-merge-zero-setup)** | Teams wanting zero-setup, enhancing the open-source features, additional enterprise features, and managed hosting | 2 minutes | Free tier available | [![Static Badge](https://img.shields.io/badge/Chrome-Extension-violet)](https://chromewebstore.google.com/detail/qodo-merge-ai-powered-cod/ephlnjeghhogofkifjloamocljapahnl) @@ -131,7 +131,7 @@ pr-agent --pr_url https://github.com/owner/repo/pull/123 review - [BitBucket app installation](https://qodo-merge-docs.qodo.ai/installation/bitbucket/) - [Azure DevOps setup](https://qodo-merge-docs.qodo.ai/installation/azure/) -### 💎 Want Zero-Setup? Try Qodo Merge +### 💎 Try Qodo Merge (Zero Setup) If you prefer a hosted solution without managing infrastructure: