Bitbucket CLI

Fast, scriptable CLI for Bitbucket Cloud

Inspired by GitHub's gh CLI - the same great experience for Bitbucket

_{Docs · Quick Start · Command Reference · Issues}

_{Note: This is an unofficial, community-maintained CLI tool.
It is not affiliated with or endorsed by Atlassian or Bitbucket.}

---

At a glance

• Stay in the terminal for repo and PR workflows
• JSON output for scripting and automation
• Auto-detects workspace and repo from your git directory

---

Install

npm install -g @pilatos/bitbucket-cli

bb --version

Requires: Bun runtime 1.0 or higher (Node.js is not supported)

---

Quick Start

bb auth login
bb repo clone myworkspace/myrepo
bb pr list

---

Common Commands

bb repo list
bb pr create --title "Add feature"
bb pr approve 42
bb config set defaultWorkspace myworkspace

Global options: --json, --no-color, -w, --workspace, -r, --repo

---

Docs

Full documentation: bitbucket-cli.paulvanderlei.com

• Quick Start Guide
• Command Reference
• Guides (Scripting, CI/CD)
• Help (Troubleshooting, FAQ)

---

Authentication

• Create a token: Bitbucket API Tokens
• Authenticate: bb auth login

Note: Bitbucket app passwords are deprecated. Use API tokens instead.

---

Contributing

Read the Contributing Guide to get started.

---

Acknowledgments

• Inspired by GitHub CLI (gh)
• Built with Commander.js
• Uses the Bitbucket Cloud REST API

---

License

MIT License - see LICENSE for details.