bktlisted

# Bitbucket CLI (bkt) `bkt` is a unified CLI for **Bitbucket Data Center** and **Bitbucket Cloud**. It mirrors `gh` ergonomics and provides structured JSON/YAML output for automation. ## Before You Start **1. Verify installation** — always check before running any `bkt` command: ```bash bkt --version ``` If not installed: | Platform | Command | |----------|---------| | macOS/Linux | `brew install avivsinai/tap/bitbucket-cli` | | Windows | `scoop bucket add avivsinai https://github.com/avivsinai/scoop-bucket && scoop install bitbucket-cli` | | Go | `go install github.com/avivsinai/bitbucket-cli/cmd/bkt@latest` | | Binary | Download from [GitHub Releases](https://github.com/avivsinai/bitbucket-cli/releases) | **2. Check authentication** — most commands require an active session: ```bash bkt auth status ``` **Bitbucket Cloud Token Requirements:** - Create an "API token with scopes" (not a general API token) - Select **Bitbucket** as the application - Required scope: **Account: Read** (`read:user:bitbucket`) - Additional scopes as needed: Repositories, Pull requests, Issues For config-free use in containers and CI pipelines, see [headless authentication](rules/headless.md). If not authenticated, log in: ```bash # Data Center (PAT-based) bkt auth login https://bitbucket.example.com --username alice --token <PAT> # Bitbucket Cloud — OAuth (official binaries open browser out of the box) bkt auth login https://bitbucket.org --kind cloud --web # Bitbucket Cloud — API tok