A command-line interface for Bitbucket Cloud
npm install @pilatos/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.
---
- Stay in the terminal for repo and PR workflows
- JSON output for scripting and automation
- Auto-detects workspace and repo from your git directory
---
``bash`
npm install -g @pilatos/bitbucket-cli
`bash`
bb --version
> Requires: Bun runtime 1.0 or higher (Node.js is not supported)
---
`bash`
bb auth login
bb repo clone myworkspace/myrepo
bb pr list
---
`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
---
Full documentation: bitbucket-cli.paulvanderlei.com
- Quick Start Guide
- Command Reference
- Guides (Scripting, CI/CD)
- Help (Troubleshooting, FAQ)
---
- Create a token: Bitbucket API Tokens
- Authenticate: bb auth login
> Note: Bitbucket app passwords are deprecated. Use API tokens instead.
---
Read the Contributing Guide to get started.
---
- Inspired by GitHub CLI (gh`)
- Built with Commander.js
- Uses the Bitbucket Cloud REST API
---
MIT License - see LICENSE for details.