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}

<sub>Note: This is an unofficial, community-maintained CLI tool.

It is not affiliated with or endorsed by Atlassian or Bitbucket.</sub>

---

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

``bash
npm install -g @pilatos/bitbucket-cli
`

`bash
bb --version
`

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

---

Quick Start

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

---

Common Commands

`bash
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.