pr-agent/docs/docs/installation/qodo_merge.md

Qodo Merge is a versatile application compatible with GitHub, GitLab, and BitBucket, hosted by QodoAI. See here for more details about the benefits of using Qodo Merge.

Usage and Licensing

Cloud Users

Non-paying users will enjoy feedback on up to 75 PRs per git organization per month. Above this limit, PRs will not receive feedback until a new month begins.

For unlimited access, user licenses (seats) are required. Each user requires an individual seat license. After purchasing seats, the team owner can assign them to specific users through the management portal.

With an assigned seat, users can seamlessly deploy the application across any of their code repositories in a git organization, and receive feedback on all their PRs.

Enterprise Account

For companies who require an Enterprise account, please contact us to initiate a trial period, and to discuss pricing and licensing options.

Install Qodo Merge for GitHub

GitHub Cloud

Qodo Merge for GitHub cloud is available for installation through the GitHub Marketplace.

{width=468}

GitHub Enterprise Server

To use Qodo Merge on your private GitHub Enterprise Server, you will need to contact Qodo for starting an Enterprise trial.

(Note: The marketplace app is not compatible with GitHub Enterprise Server. Installation requires creating a private GitHub App instead.)

GitHub Open Source Projects

For open-source projects, Qodo Merge is available for free usage. To install Qodo Merge for your open-source repositories, use the following marketplace link.

Install Qodo Merge for Bitbucket

Bitbucket Cloud

Qodo Merge for Bitbucket Cloud is available for installation through the following link

{width=468}

Bitbucket Server

To use Qodo Merge application on your private Bitbucket Server, you will need to contact us for starting an Enterprise trial.

Install Qodo Merge for GitLab

GitLab Cloud

Since GitLab platform does not support apps, installing Qodo Merge for GitLab is a bit more involved, and requires the following steps:

Step 1

Acquire a personal, project or group level access token. Enable the “api” scope in order to allow Qodo Merge to read pull requests, comment and respond to requests.

{width=750}

Store the token in a safe place, you won’t be able to access it again after it was generated.

Step 2

Generate a shared secret and link it to the access token. Browse to https://register.gitlab.pr-agent.codium.ai. Fill in your generated GitLab token and your company or personal name in the appropriate fields and click "Submit".

You should see "Success!" displayed above the Submit button, and a shared secret will be generated. Store it in a safe place, you won’t be able to access it again after it was generated.

Step 3

Install a webhook for your repository or groups, by clicking “webhooks” on the settings menu. Click the “Add new webhook” button.


In the webhook definition form, fill in the following fields: URL: https://pro.gitlab.pr-agent.codium.ai/webhook

Secret token: Your QodoAI key Trigger: Check the ‘comments’ and ‘merge request events’ boxes. Enable SSL verification: Check the box.

{width=750}

Step 4

You’re all set!

Open a new merge request or add a MR comment with one of Qodo Merge’s commands such as /review, /describe or /improve.

GitLab Server

For limited free usage on private GitLab Server, the same installation steps as for GitLab Cloud apply. For unlimited usage, you will need to contact Qodo for moving to an Enterprise account.