Changelog

A curated summary of recent releases. The full, machine-generated changelog lives in the GitHub repository and is updated on every release.

Tip

Hide the in-CLI update nudge with bb config set skipVersionCheck true. See Configuration File for related settings.

Unreleased — bb browse

Open Bitbucket Cloud web pages — repo home, files, branches, commits, pull requests, pipelines, settings — directly from the terminal. Mirrors gh browse.

• Smart positional resolution: bb browse 217 opens PR #217, bb browse abc1234 opens a commit, bb browse src/cli.ts:42 opens a file at a line on the current branch.
• Resource flags for every top-level repo page: --pr, --prs, --branch, --branches, --commit (defaults to HEAD), --commits, --pipelines, --pipeline, --downloads, --issue, --issues, --wiki, --settings.
• --no-browser prints the URL to stdout; --json url emits { "url": "..." } for scripting.
• Outside a git checkout, falls back to Bitbucket’s HEAD segment so --workspace/--repo overrides Just Work.

bb browse                                # repo home
bb browse src/cli.ts:42                  # file at a line on the current branch
bb browse --branch release/2.0           # branch tree
bb browse 217                            # PR #217
bb browse --pipelines                    # pipelines tab
bb browse --pr 217 --json url            # capture the URL for a script

See the Browse command reference for the full flag list and examples.

1.14.0 — --json <fields> projection and --jq <expression>

Match the gh CLI’s JSON formatting flags so muscle memory and scripts port over cleanly.

• --json [fields] accepts an optional comma-separated field list (e.g. --json number,title,author.display_name). Bare --json keeps the existing full-object output for backwards compatibility.
• --jq <expression> runs the JSON output through an embedded jq-wasm engine. Requires --json.
• Field projection drops the wrapper around list-style results (e.g. pullRequests, repositories, snippets) and projects per-item, matching gh semantics.
• Dotted paths (author.display_name) traverse nested objects.
• Invalid jq expressions exit non-zero with the underlying jq error.

bb pr list --json number,title,state
bb pr list --json author --jq '.[].author.display_name'
bb pr list --json number,title,state --jq '.[] | select(.state == "OPEN") | .title'

See the Scripting & Automation guide for end-to-end examples.

1.13.x — Stability and CI hardening

• CI runs the full test + build matrix on Ubuntu, macOS, and Windows. Bun and every GitHub Action are pinned to explicit versions/SHAs, and the release pipeline no longer tags or publishes until lint, format, and tests all pass.
• --limit 0 now errors instead of silently returning no results. parseLimit rejects any non-positive or non-finite value with a VALIDATION_INVALID BBError.
• Generated API client refreshed from the latest Bitbucket Cloud OpenAPI spec, with a post-generation patch that dedupes duplicate enum declarations and corrects PipelineSelector.type optionality.

1.13.0 — Default reviewers

• bb repo default-reviewers lets you inspect and manage the default reviewers configured on a repository, the same list Bitbucket suggests when someone opens a PR through the web UI.
• bb pr create picks up those default reviewers automatically when the prCreateIncludeDefaultReviewers config key is enabled. See bb pr create for the full flow.

Older releases

For releases prior to 1.13.0 — and the complete per-PR commit log — see the full CHANGELOG on GitHub.