# Install bb-cli with Homebrew, apt, Nix, zypper, winget Bitbucket Rest API CLI written in pure PHP. Version 1.4.1 via Homebrew; verified from local package data. Also installable with debian: sudo apt install bb. ## Install ```sh sudo av install brew:bb-cli ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install bb-cli ``` Evidence: local Homebrew formula metadata ### Linux - Debian apt (92%): ```sh sudo apt install bb ``` Evidence: Debian stable package indexes: bb from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz - Nix (92%): ```sh nix profile install nixpkgs#bb ``` Evidence: nixpkgs package indexes: pkgs/by-name/bb/bb/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - zypper (92%): ```sh sudo zypper install bb ``` Evidence: openSUSE Tumbleweed package metadata: bb from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst ### Windows - winget (92%): ```sh winget install --id vriesdemichael.bb -e ``` Evidence: Windows Package Manager source index: vriesdemichael.bb from https://cdn.winget.microsoft.com/cache/source.msix ## Package facts - **Package key:** brew:bb-cli - **Package manager:** Homebrew - **Version:** 1.4.1 - **Source summary:** Bitbucket Rest API CLI written in pure PHP - **Homepage:** - **Repository:** - **Generated:** 2026-08-03T19:37:03+00:00 ## Executables - bb (alias) ## Install behavior - Bottle: not available ## Freshness - Page generated: 2026-08-03 - Package-manager version: 1.4.1 ## Project history and usage bb-cli is a PHP command-line client for Bitbucket's REST API, packaged as the `bb` executable for developers who want pull requests, pipelines, branches, and other Bitbucket workflows in a terminal. ### Project history The project README presents it as "Bitbucket Rest API CLI" and documents installation as a standalone binary from GitHub releases or via a container image. Its own development note dates the tool to 2021 and says it was developed with help from GitHub Copilot. The CLI is intentionally narrow: it wraps Bitbucket operations rather than trying to be a general Atlassian or Git hosting client. That makes it a small but recognizable example of service-specific CLIs that grew around cloud Git hosting. ### Adoption history Homebrew packages the tool as `bb-cli`; the supplied package-manager facts also show names in Debian, Ubuntu, Nix, zypper, and winget ecosystems, indicating cross-platform packaging beyond the upstream release binaries. ### How it is used Typical use is interactive developer workflow from a shell: run `bb help`, authenticate with `bb auth`, then inspect or operate on Bitbucket pull requests, pipelines, and branches. The documented Docker setup bind-mounts the same config file into the container. ### Why package nerds care For package-index history, bb-cli is a useful example of a modern SaaS API wrapper distributed through both language/runtime channels and native package managers. It is not a foundational Unix tool, but it represents the package-manager demand for one-command access to hosted development platforms. ### Timeline - 2021: README development note says the tool was developed with help from GitHub Copilot. - Current: README documents standalone GitHub release binaries and a GHCR container image. ### Related projects - Related tools include Atlassian/Bitbucket web APIs, general Git hosting CLIs such as GitHub CLI, and other service-specific terminal clients. ### Sources - - - input:source_facts.package-manager ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: ~/.bitbucket-rest-cli-config.json ## Credential files - Unix: ~/.bitbucket-rest-cli-config.json ## Other Package-Manager Records - Debian apt - bb - 1.3rc1-13+b1: installed executable or alias match | Debian stable package indexes: bb from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | ASCII-art demo based on AAlib | https://aa-project.sourceforge.net/bb/ - Nix - bb: installed executable or alias match | nixpkgs package indexes: pkgs/by-name/bb/bb/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - Ubuntu apt - bb - 1.3rc1-13: installed executable or alias match | Ubuntu 24.04 LTS package indexes: bb from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | ASCII-art demo based on AAlib | https://aa-project.sourceforge.net/bb/ - zypper - bb - 1.3~rc1-2.7: installed executable or alias match | openSUSE Tumbleweed package metadata: bb from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Audio-Visual Demonstration for Text Terminal | https://aa-project.sourceforge.net/bb/ - winget - vriesdemichael.bb: installed executable or alias match | Windows Package Manager source index: vriesdemichael.bb from https://cdn.winget.microsoft.com/cache/source.msix ## Combined YAML source View the package source record on GitHub. [combined/bb-cli.yml](https://github.com/mxcl/pkgdb/blob/main/combined/bb-cli.yml) ## Sources - pkg.so package database - Geiger risk classifier - curated configuration and credential file locations - curated package history - pkgdb category and tag curation - external package-manager database matches - cross-ecosystem install command graph