Guide for Bitbucket

Integrate the AI Code Review Agent into your Bitbucket workflow.

Speed up code reviews by configuring the AI Code Review Agent with your Bitbucket repositories. In this guide, you'll learn how to set up the Agent to receive automated code reviews that trigger whenever you create a pull request, as well as how to manually initiate reviews using available commands.

The Free Plan offers AI-generated pull request summaries to provide a quick overview of changes. For advanced features like line-level code suggestions, consider upgrading to the Team Plan. For detailed pricing information, visit our Pricing page.

Get a 14-day FREE trial of Bito's AI Code Review Agent.

Video tutorial

Coming soon...

Prerequisites

Before proceeding, ensure you've completed all necessary prerequisites.

1. Create a Bitbucket App Password:

For Bitbucket pull request code reviews, you’ll need to connect your Bito workspace to your Bitbucket account.

Start by creating an App Password. App Passwords allow apps like Bito to access your Bitbucket account. Make sure that the App Password is created by a Bitbucket user who has the Admin access role to the repositories.

Ensure the required permissions are checked:

  • Under Account, select Read.

  • Under Pull requests, select Write.

  • Under Webhooks, select Read and write.

Installation and configuration steps

Follow the step-by-step instructions below to install the AI Code Review Agent using Bito Cloud:

Step 1: Log in to Bito

Log in to Bito Cloud and select a workspace to get started.

Step 2: Open the Code Review Agents setup

Click Repositories under the CODE REVIEW section in the sidebar.

Step 3: Select your Git provider

Bito supports integration with the following Git providers:

  • GitHub

  • GitHub (Self-Managed)

  • GitLab

  • GitLab (Self-Managed)

  • Bitbucket

Since we are setting up the Agent for Bitbucket, select Bitbucket to proceed.

Step 4: Connect Bito to Bitbucket

To enable pull request reviews, you’ll need to connect your Bito workspace to your Bitbucket account.

Start by creating an App Password. App Passwords allow apps like Bito to access your Bitbucket account. Make sure that the App Password is created by a Bitbucket user who has the Admin access role to the repositories.

Ensure the required permissions are checked:

  • Under Account, select Read.

  • Under Pull requests, select Write.

  • Under Webhooks, select Read and write.

For guidance, refer to the instructions in the Prerequisites section.

Once generated, enter your Bitbucket username and App password into the input fields in Bito.

Click Authorize to ensure the login credentials are working correctly.

If the credentials are successfully authorized, you can select your Bitbucket workspace from the dropdown menu.

Click Connect Bito to Bitbucket to proceed.

Step 5: Enable AI Code Review Agent on repositories

After connecting Bito to your Bitbucket account, you need to enable the AI Code Review Agent for your repositories.

Click the Go to repository list button to view all repositories Bito can access in your Bitbucket account.

Use the toggles in the Code Review Status column to enable or disable the Agent for each repository.

To customize the Agent’s behavior, you can edit existing configurations or create new Agents as needed.

Learn more

Step 6: Automated and manual pull request reviews

Once a repository is enabled, you can invoke the AI Code Review Agent in the following ways:

  1. Automated code review: By default, the Agent automatically reviews all new pull requests and provides detailed feedback.

  2. Manually trigger code review: To initiate a manual review, simply type /review in the comment box on the pull request and click Add comment now to submit it. This action will start the code review process.

Note: After typing /review, add a space inside the comment box to ensure that /review is not highlighted as a Bitbucket slash command so that the comment can be posted correctly.

The AI-generated code review feedback will be posted as comments directly within your pull request, making it seamless to view and address suggestions right where they matter most.

Note: To enhance efficiency, the automated code reviews are only triggered for pull requests merging into the repository’s default branch. This prevents unnecessary processing and Advanced AI requests usage.

To review additional branches, you can use the Include Source/Target Branches filter. Bito will review pull requests when the source or target branch matches the list.

The Include Source/Target Branches filter applies only to automatically triggered reviews. Users should still be able to trigger reviews manually via the /review command.

The AI Code Review Agent automatically reviews code changes up to 5000 lines when a pull request is created. For larger changes, you can use the /review command.

It may take a few minutes to get the code review posted as a comment, depending on the size of the pull request.

Step 7: Specialized commands for code reviews

Bito also offers specialized commands that are designed to provide detailed insights into specific areas of your source code, including security, performance, scalability, code structure, and optimization.

  • /review security: Analyzes code to identify security vulnerabilities and ensure secure coding practices.

  • /review performance: Evaluates code for performance issues, identifying slow or resource-heavy areas.

  • /review scalability: Assesses the code's ability to handle increased usage and scale effectively.

  • /review codeorg: Scans for readability and maintainability, promoting clear and efficient code organization.

  • /review codeoptimize: Identifies optimization opportunities to enhance code efficiency and reduce resource usage.

By default, the /review command generates inline comments, meaning that code suggestions are inserted directly beneath the code diffs in each file. This approach provides a clearer view of the exact lines requiring improvement. However, if you prefer a code review in a single post rather than separate inline comments under the diffs, you can include the optional parameter: /review #inline_comment=False

For more details, refer to Available Commands.

Step 8: Chat with AI Code Review Agent

Ask questions directly to the AI Code Review Agent regarding its code review feedback. You can inquire about highlighted issues, request alternative solutions, or seek clarifications on suggested fixes.

To start the conversation, type your question in the comment box within the inline suggestions on your pull request, and then submit it. Typically, Bito AI responses are delivered in about 10 seconds. On GitHub and Bitbucket, you need to manually refresh the page to see the responses, while GitLab updates automatically.

Bito supports over 20 languages—including English, Hindi, Chinese, and Spanish—so you can interact with the AI in the language you’re most comfortable with.

Screenshots

Screenshot # 1

AI-generated pull request (PR) summary

Screenshot # 2

Changelist showing key changes and impacted files in a pull request.

Changelist in AI Code Review Agent's feedback.

Screenshot # 3

AI code review feedback posted as comments on the pull request.

Last updated

Was this helpful?