Bitbucket CLI

Clone repos, manage PRs, and automate workflows — all from your terminal. If you know GitHub's gh, you'll feel right at home.

Get Started View on GitHub

Install

Requires Bun 1.0+ runtime.

npm install -g @pilatos/bitbucket-cli

pnpm add -g @pilatos/bitbucket-cli

bun install -g @pilatos/bitbucket-cli

bb auth login                          # authenticate
bb repo clone myworkspace/myrepo       # clone a repo
bb pr create -t "My awesome feature"   # create a PR
bb pr list                             # list open PRs

What can you do?

Repository Management

Clone, create, list, view, and delete repositories.

bb repo clone workspace/repo
bb repo create my-new-project
bb repo list -w myworkspace

Pull Request Workflows

Full PR lifecycle — create, review, approve, merge.

bb pr create -t "Add feature"
bb pr approve 42
bb pr merge 42 --strategy squash

Code Review

View diffs, checkout PR branches, inspect checks.

bb pr diff 42
bb pr checkout 42
bb pr checks 42

Jump to the Web UI

Open Bitbucket pages — PRs, files, commits, settings — in your browser.

bb browse 42
bb browse src/cli.ts:20
bb browse --pipelines

Scripting & Automation

JSON output on every command. Built for CI/CD.

bb pr list --json | jq '.pullRequests[].title'

PR Workflows

Task-focused guides for the shortest path to a result.

Create and update PRs Open pull requests, edit titles and descriptions.

Review and merge Approve, decline, mark ready, merge with strategy controls.

Diffs and checkout View patches, open browser diffs, checkout branches locally.

Comments and reviewers Script-friendly review comments and reviewer management.

All PR commands

Explore

Command Reference All commands and options.

Scripting Guide JSON output, exit codes, shell patterns.

CI/CD Integration GitHub Actions, GitLab CI, Jenkins, and more.

Troubleshooting Common issues and solutions.

Community

This is an unofficial, community-maintained CLI. Not affiliated with Atlassian.