Guide for Bitbucket (Self-Managed)
Integrate the AI Code Review Agent into your self-hosted Bitbucket workflow.
Speed up code reviews by configuring the AI Code Review Agent with your Bitbucket (Self-Managed) server. 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.
Video tutorial
coming soon...
Prerequisites
Before proceeding, ensure you've completed all necessary prerequisites.
1. Create a Bitbucket Personal Access Token:
For Bitbucket pull request code reviews, a token with Project Admin
permission is required. Make sure that the token is created by a Bitbucket user who has the Admin
privileges.
You can use the Create Token button that appears once you provide the Hosted Bitbucket URL and your Bitbucket username.

Or directly visit the URL of your self-hosted Bitbucket.
To create a token for your user account:
Go to Profile picture > Manage account > HTTP access tokens.
Select Create token.
Set the token name, permissions, and expiry.



2. Authorizing a Bitbucket Personal Access Token for use with SAML single sign-on:
If your Bitbucket organization enforces SAML Single Sign-On (SSO), you must authorize your Personal Access Token through your Identity Provider (IdP); otherwise, Bito's AI Code Review Agent won't function properly.
For more information, please refer to Bitbucket SAML SSO documentation.
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
Bitbucket (Self-Managed)
Since we are setting up the Agent for Bitbucket (Self-Managed) server, select Bitbucket (Self-Managed) to proceed.

Step 4: Connect Bito to Bitbucket
To enable pull request reviews, you’ll need to connect your Bito workspace to your Bitbucket (Self-Managed) server.
You need to enter the details for the below mentioned input fields:
Hosted Bitbucket URL: This is the domain portion of the URL where your Bitbucket Enterprise server is hosted (e.g.,
https://bitbucket.mycompany.com
). Please check with your Bitbucket administrator for the correct URL.Bitbucket username: This is your Bitbucket username used for login. Please check it from your user profile page or ask your Admin.
Personal Access Token: Generate a Bitbucket Personal Access Token with
Project Admin
permission in your Bitbucket (Self-Managed) account. Ensure you have Bitbucket Admin privileges. Enter the token into the Personal Access Token input field. You can use the Create Token button that appears once you provide the Hosted Bitbucket URL and your Bitbucket username.For guidance, refer to the instructions in the Prerequisites section.
Click Validate to ensure the token is functioning properly.

If the token is successfully validated, click Connect Bito to Bitbucket to proceed.
Step 5: Enable AI Code Review Agent on repositories
After connecting Bito to your Bitbucket self-managed server, you need to enable the AI Code Review Agent for your repositories.
Use the toggles in the Code Review Status column to enable or disable the Agent for each repository.
Step 6: Automated and manual merge request reviews
Once a repository is enabled, you can invoke the AI Code Review Agent in the following ways:
Automated code review: By default, the Agent automatically reviews all new pull requests and provides detailed feedback.
Manually trigger code review: To initiate a manual review, simply type
/review
in the comment box on the pull request and submit it. This action will start the code review process.
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.
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.
Last updated