Bringing AI code reviews into your Bitbucket workspace
Bitbucket has long been the backbone for software teams invested in Jira, Confluence, and the broader Atlassian ecosystem. As AI coding tools accelerate PR creation velocity across teams, engineering leads have faced a difficult choice: rely on subjective human code reviews that slow down sprints, or install noisy bot integrations that clutter comment threads.
With CodeOtter v0.4.0, we are introducing first-class, self-hosted integration for Bitbucket.

Now, engineering teams can bring CodeOtter's calibrated dual-engine review platform directly into their Atlassian workspaces—completely self-hosted, private, and customizable.
What is included in the Bitbucket integration
1. Bitbucket OAuth 2.0 Authentication
Sign into CodeOtter directly with your Bitbucket account. Teams can link their personal accounts or configure workspace-wide OAuth credentials, respecting Bitbucket role-based permissions and team access levels out of the box.
2. Multi-Workspace & Private Repository Support
CodeOtter seamlessly queries and syncs with all repositories across your Bitbucket workspaces:
- Automatic webhook provisioning on pull request events (
pullrequest:created,pullrequest:updated). - Strict repository isolation and privacy—your diffs never leave your self-hosted boundary when using local models or your private BYOK keys.
- Granular configuration per repository or workspace using repo-level
.codeotter.ymlguidelines.
3. Inline PR Comments & Smart Upserts
Nobody likes comment spam on pull requests. CodeOtter interacts with Bitbucket's Pull Request REST API using intelligent comment reconciliation:
- Executive Scorecard: A pinned summary comment detailing 6 calibrated 0–100 gauge scores and binary merge gates.
- Inline File Findings: Precise, hunk-targeted remediation diffs anchored directly to the modified lines in the Bitbucket diff viewer.
- Automatic Cleanups: When new commits are pushed, outdated suggestions are automatically updated or marked resolved, keeping code reviews focused.
4. Deterministic Pre-Merge Gates
Bitbucket branch permissions and merge checks can be paired with CodeOtter's binary gates:
- Security Check: Verifies that diffs do not introduce unescaped SQL, hardcoded secrets, or unvalidated inputs.
- Blast Radius: Calculates ripple effects across dependent services before code merges into master/main.
- Test Adequacy & PR Hygiene: Enforces that critical business logic includes corresponding test coverage and clear PR descriptions.
Universal Dual-Engine Review Architecture
Every Bitbucket pull request is processed by two specialized engines running in parallel:
- System One Rubric & Gate Engine: Evaluates typed rubrics deterministically to produce objective 0–100 quality scores and enforce 9 binary pre-merge safety gates.
- Generative Language Model Engine: Crafts human-readable summaries and file-by-file walkthroughs powered by Claude, OpenAI, OpenRouter, or offline local sidecars (llama-server / GGUF).
All outputs are validated and normalized through our judge() pipeline before being sent to Bitbucket, ensuring your reviews are accurate, reproducible, and trustworthy.
Get Started with Bitbucket
Setting up Bitbucket with CodeOtter v0.4.0 takes less than five minutes:
- Create an OAuth consumer in Bitbucket Settings > Workspace Settings > OAuth consumers.
- Add your Bitbucket Client ID and Secret to your CodeOtter environment settings.
- Select your repositories, and CodeOtter will automatically handle the rest on your next pull request!
- Release Downloads: GitHub Release v0.4.0
- Documentation: Check out our Bitbucket integration setup guide.


