@pilatos/bitbucket-cli
v1.8.3
Published
A command-line interface for Bitbucket Cloud
Readme
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-clibb --versionRequires: Bun runtime 1.0 or higher (Node.js is not supported)
Quick Start
bb auth login
bb repo clone myworkspace/myrepo
bb pr listCommon Commands
bb repo list
bb pr create --title "Add feature"
bb pr approve 42
bb config set defaultWorkspace myworkspaceGlobal 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.
