Bitbucket Data Center

The operational CLI for Bitbucket Data Center.

bb gives Bitbucket Data Center teams a safer command line: machine-readable output, dry-run planning, repository-aware ergonomics, and behavior validated against a real server.

Get Started Browse Commands See Safety Model

Data Center only — Bitbucket Cloud is not supported

bb talks to the Bitbucket Data Center REST API. Bitbucket Cloud (bitbucket.org) is a different API, and no bb command will work against it. If your repositories live on bitbucket.org, this is not your CLI.

Operational Safety

Plan server changes before you apply them

Dry-run planning and bulk review/apply workflows reduce the usual risk of shelling directly into enterprise Bitbucket instances.

Automation Contract

Stable output for CI, tooling, and agents

The CLI wraps every --json payload in the same small envelope, so scripts, pipelines and LLM agents are not parsing human prose.

Live-Tested

Validated against real Bitbucket behavior

Command workflows are validated against Bitbucket Data Center APIs, which keeps the docs and the binary grounded in real platform behavior.

Start here

Install

Installation and Quickstart

Download a release, verify checksums, install bb, authenticate with a PAT, and run the first useful commands.

Cheatsheet

Developer Cheatsheet & Cookbook

Scannable reference tables, daily pull request loops, git authentication, and shell autocompletion recipes.

Operate

Basic Usage

Learn the command discovery pattern, repository inference rules, dry-run behavior, and the JSON machine contract.

Reference

All Commands

Use the generated command tree as the exact public surface area for every command, argument, and flag.

Automate

Advanced Topics

Dive into repository discovery, dry-run semantics, bulk operations, and diagnostics for higher-trust automation.

Stuck

Troubleshooting

Paste the message you got. Start with bb doctor, which reads every configuration file and needs no host.

Translate

Coming from gh

The command each gh one maps to, where the spelling differs, and the few places there is no counterpart.

What this docs site contains

Operator-facing guidance

• Installation and Quickstart
• Developer Cheatsheet & Cookbook
• Basic Usage
• Troubleshooting
• Coming from gh
• Advanced Topics
• JSON Schemas

Source-of-truth generated reference

• Command Reference Overview
• Complete CLI command reference
• AI and llms.txt guide
• Architecture decision records
• Release changelog

Documentation model

• Command and ADR pages are generated from source-of-truth code and decision records.
• Bulk policy, plan, and apply schemas are generated from validated workflow models.
• The hand-written docs focus on usage patterns, safety contracts, and operator workflows around the CLI.