Repository navigation
v0.1.0
First release of bb — an opinionated, macOS-first CLI for Bitbucket Cloud, forked from gildas/bitbucket-cli and substantially reworked. The fork is permanently detached from upstream; versioning starts fresh at v0.1.0.
Command surface
pullrequest(pr) — list/get/create/update/merge/decline/approve/request-changes, diff/patch/commits/activities, plus comments and tasks (positional PR ids)pipeline— list/get/trigger/stop (y/N confirmation,--forceto skip), andpipeline stepget/list/logs/report/cases with step name→UUID resolutionrepository,workspace,commit,branch— read-only surface, plusrepo cloneartifact— list/downloadprofile/user— authentication (app password, access token, OAuth client), secrets stored in the macOS Keychain
Highlights
- Works with narrowly-scoped workspace/repository tokens — nothing demands
read:workspace - Full-preflight
--dry-runon every mutating command: targets resolved via real GETs, the resolved payload echoed, no write ever sent --comment-file/--description-file(-= stdin) for markdown bodies without shell-quoting hazards- Secrets masked in table output; explicit
-o json|yamlis the scripting path bb install-skillinstalls an embedded Claude agent skill (to~/.claudeor$CLAUDE_CONFIG_DIR)- Dynamic shell completion throughout
Install
brew tap avitsrimer/apps
brew install --cask bbdarwin/arm64 only.