Skip to main content
Integrating Qodo with Bitbucket is a straightforward process that can be applied to a single repository or scaled across multiple workspaces. Setup typically takes just a few minutes and includes authentication and pipeline configuration. Once connected, Qodo automatically processes your pull requests and provides reviews, summaries, and improvement suggestions as part of your Bitbucket workflow.

​
1. Log in to the Qodo portal

Before setting up Qodo, make sure you have created a Qodo account and signed in.

​
2. Set up Qodo on BitBucket

After signing in to your Qodo account, follow the steps below to set up Qodo on Bitbucket.

​
Bitbucket App

This installation method is available to subscribed users only. Visit Qodo’s Subscription Plans page to learn more.
  1. Go to the Qodo Git plugin Pro app page.
  2. Choose which workspace Qodo should have access to, then click Grant access.

​
Bitbucket Server

Contact Qodo to use Qodo Git interface on your private Bitbucket Server.

​
Bitbucket Pipeline

Pull request comments are not supported when using Bitbucket Pipelines.
1

Create a pipeline file:

Create a new file named bitbucket-pipelines.yml with the content below:
pipelines:
    pull-requests:
      '**':
        - step:
            name: PR Agent Review
            image: codiumai/pr-agent:latest
            script:
              - pr-agent --pr_url=https://bitbucket.org/$BITBUCKET_WORKSPACE/$BITBUCKET_REPO_SLUG/pull-requests/$BITBUCKET_PR_ID review
2

Select your authentication type:

  • bearer = just a token (more secure, no username/password exposure).
  • basic = username + password (or app password) combined and encoded.
3

Create a token:

Based on your authentication type, create a token.
  • If your authentication type is bearer, generate an access token for your Bitbucket repository:
    1. Go to your repository’s settings.
    2. Select Security then Access Tokens.
    3. Generate an access token and save it somewhere safe.
  • If your authentication type is basic, generate a base64 encoded token from your username:password combination and save it somewhere safe.
4

Add secure variables:

a. Go to your repository’s settings.
b. Select Pipelines.
c. Under Repository variables, add the following variables:
  • OPENAI_API_KEY: <your key>
  • BITBUCKET.AUTH_TYPE: basic or bearer (default is bearer)
  • BITBUCKET__BEARER_TOKEN or BITBUCKET.BASIC_TOKEN: <your token> (obtained from step 3)
You’re all set. You can now start using Qodo.
Visit Using Qodo in PRs to learn about next steps and how to get the most out of Qodo.