Bitbucket Cloud CLI

Command-line tool for managing Bitbucket Cloud via af bitbucket (alias af bb).

Setup

Bitbucket Cloud authentication is separate from Jira/Confluence. Atlassian API tokens scoped for Jira do not authenticate against Bitbucket Cloud — they return 401. Add the following to your project's .env:

• BITBUCKET_USERNAME — Bitbucket username or workspace token label (falls back to ATLASSIAN_EMAIL / JIRA_EMAIL)
• BITBUCKET_API_TOKEN — Workspace API token or app password (BITBUCKET_APP_PASSWORD is also accepted as a legacy alias)

Generate credentials:

• Workspace API token (recommended for automation) — https://bitbucket.org/<workspace>/workspace/settings/api-tokens
• App password — https://bitbucket.org/account/settings/app-passwords/

Verify credentials with af bb whoami — it prints the authenticated account (and its account ID). If that fails, nothing else will.

Workspace and Repo Resolution