Skip to main content
Using a self-hosted instance? Follow the Bitbucket Data Center setup guide.

​
Before you begin

  • A Bitbucket Cloud account with access to the workspace and repositories you want reviewed.
  • A workspace administrator who can install the CodeAnt AI app, or an Atlassian API token for the token connection below.
  • A repository where you can open a pull request.

​
Connect your workspace

Choose one connection method. Use the app installation for a shared workspace, or the API token flow for a personal workspace.
1

Sign in with Bitbucket

Open the CodeAnt AI dashboard and sign in with Bitbucket. Choose the workspace you want reviewed.
2

Install CodeAnt AI in the workspace

On the repository connection screen, select Configure Bitbucket Workspace to open the Atlassian installation flow. Install CodeAnt in the same workspace. Ask a workspace administrator to complete the installation if you do not have access to workspace app settings.
3

Check repository access

Return to CodeAnt and select Check for Repositories. Confirm that the workspace’s repositories are available before continuing.
The app enables reviews for all repositories in the workspace by default. Use Choose which repositories to review below to limit that selection before trying a review.

​
Choose which repositories to review

  1. In CodeAnt AI, open Settings → AI Code Review.
  2. Scroll to Configure Repos and select Configure.
  3. Keep the repositories you want reviewed checked. Uncheck any repositories you want to exclude.
  4. Select Save Changes.
Start with one repository so you can verify the integration before enabling more.

​
Get your first review

Open a pull request in an enabled repository. CodeAnt AI reviews the changes and posts feedback directly on the PR. When it finds an issue, its comment explains the problem, severity, and suggested fix. See how to read a review comment. To review an existing PR or rerun a review, post this comment on the pull request:

​
Troubleshooting

Confirm that you are using the intended workspace and have access to its app settings. Ask a workspace administrator to install the app. For a personal workspace, use the API token connection above.
Check that the email address belongs to the account that created the token, that the token has not expired or been revoked, and that all scopes in the table are selected. Create a replacement scoped token if any scopes are missing, then select Connect Workspace again.
Confirm that the API token includes both Webhooks read and write scopes. Reconnect the workspace to retry creation. If it still fails, contact CodeAnt support with the workspace name and connection error. Do not include the token.
If your API token expired or was revoked, create a new token with the same scopes and reconnect the workspace through the API token flow.
Confirm that the app or API token is connected to the PR’s workspace. Check that the repository is enabled under Settings → AI Code Review → Configure Repos, then post @codeant-ai: review on the PR. If feedback still does not appear, contact CodeAnt support with the workspace, repository name, and PR URL. Do not include your token.

​
Next steps

Customize your reviews

Add review rules for your team’s coding standards.

Configure repository scans

Choose which analyses run and which files they include.