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:

npm install -g @pilatos/bitbucket-cli

bun install -g @pilatos/bitbucket-cli

pnpm add -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 →

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 approve 42
bb pr merge 42 --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 '.[].title'

Feature Highlights

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

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.