Skip to content
Bitbucket CLI Bitbucket CLI

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

Section titled “Install”

Requires Bun 1.0+ runtime.

Terminal window
npm install -g @pilatos/bitbucket-cli
Terminal window
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?

Section titled “What can you do?”

Repository Management

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

Terminal window
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.

Terminal window
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.

Terminal window
bb pr diff 42
bb pr checkout 42
bb pr checks 42

CI/CD from the Terminal

Trigger, inspect, and stop Bitbucket Pipelines without leaving your shell.

Terminal window
bb pipeline run --branch main
bb pipeline list --status FAILED
bb pipeline logs 42

Jump to the Web UI

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

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

Scripting & Automation

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

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

Raw API Access

Reach any Bitbucket 2.0 endpoint not yet wrapped by a typed command.

Terminal window
bb api /user
bb api /repositories/{workspace}/{repo}/pullrequests --paginate
bb api POST /repositories/ws/repo/issues -f title=Bug

PR Workflows

Section titled “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

Section titled “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

Section titled “Community”

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