Bitbucket CLI

Work with Bitbucket from your terminal. Clone repos, manage PRs, and automate workflows — all without leaving the command line.

Get Started View on GitHub

Why Bitbucket CLI?

If you’ve used GitHub’s gh CLI and loved it, you’ve probably wished for something similar for Bitbucket. Now you have it.

Stay in Your Terminal

No more context-switching to the browser. Clone repos, create PRs, and review code without leaving your workflow.

Automate Everything

JSON output, scriptable commands, and CI/CD integration. Build automated workflows with ease.

Familiar Patterns

Inspired by GitHub CLI, so if you know gh, you’ll feel right at home with bb.

Smart Context Detection

Automatically detects workspace and repo from your git directory. Less typing, more doing.

Quick Start

Get productive in 60 seconds (requires Bun runtime):

npm install -g @pilatos/bitbucket-cli

pnpm add -g @pilatos/bitbucket-cli

bun install -g @pilatos/bitbucket-cli

# Authenticate
bb auth login

# Clone a repo
bb repo clone myworkspace/myrepo

# Create a PR
bb pr create -t "My awesome feature"

# List open PRs
bb pr list

Full Quick Start Guide →

Pick a Workflow New

Use task-focused guides when you want the shortest path to a result:

Create and update PRs Open pull requests quickly, then edit titles and descriptions without context switching.

Review and merge safely Approve, decline, mark draft PRs ready, and merge with explicit strategy controls.

Inspect diffs and checkout View patches, open browser diffs, or checkout PR branches locally for deep review.

Automate comments and reviewers Use script-friendly commands for review comments and reviewer management.

Browse PR command workflows

What Can You Do?

Repository Management

Clone, create, list, view, and delete repositories. Full control over your Bitbucket repos.

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

Pull Request Workflows

Complete PR lifecycle management — create, review, approve, merge, and more.

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

Code Review

View diffs, checkout PR branches locally, and review code efficiently.

bb pr diff 42
bb pr checkout 42
bb pr diff --stat

Scripting & Automation

JSON output for all commands. Perfect for CI/CD pipelines and automation scripts.

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

Feature Highlights Updated

Feature	Description
Smart Context	Auto-detects workspace/repo from git remote
JSON Output	Machine-readable output for scripting
Shell Completion	Tab completion for Bash, Zsh, and Fish
Secure Auth	API token authentication with local storage
Cross-Platform	Works on macOS, Linux, and Windows
Update Notifications	Automatic update checks to keep you current

Explore the Docs

Command Reference

Complete documentation for all commands and options.

View Commands →

Scripting Guide

Learn to use bb in scripts, automation, and CI/CD.

Learn Scripting →

Troubleshooting

Common issues and how to solve them.

Get Help →

FAQ

Answers to frequently asked questions.

Read FAQ →

Community

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