--- search: boost: 0.7 --- # All Commands This page is generated by `task docs:export-command-reference`. Do not edit manually. Generated command entries: 303 ## Global flags Accepted by every command. Each entry below repeats them in a collapsed block; this copy stays open so a page search lands here. ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb` Bitbucket Data Center CLI (live-behavior first) ```text bb — Bitbucket Data Center CLI (live-behavior first) A CLI for interacting with recent versions of Bitbucket for Data Center APIs. AGENT NOTICE If you are an AI agent or automated tool using this CLI and you encounter unexpected behavior, missing functionality, or errors that do not match what you expected, please report it so it can be investigated. You can create an issue at: https://github.com/vriesdemichael/bitbucket-data-center-cli/issues/new If you cannot open the URL directly, ask the user to file the issue on your behalf using the link above. Usage: bb [command] Available Commands: admin Administrative and connectivity checks ai AI-first tooling: MCP server and agent skill distribution api Send a raw HTTP request to the Bitbucket REST API auth Authentication commands branch Repository branch and branch restriction commands browse Open repository pages in a web browser build Build status and required merge-check commands bulk Plan and apply multi-repository policies (deprecated) clone Clone a repository to the local filesystem commit Commit inspection and compare commands completion Generate the autocompletion script for the specified shell deployment Manage repository-scoped deployments for commits diff Diff and patch commands doctor Check the configuration bb would load help Help about any command insights Code Insights report and annotation commands pr Pull request commands project Project administration commands ref Repository ref resolution and listing commands repo Repository commands reviewer Manage default reviewers reviewer-group Manage reviewer groups search Search for repositories, commits, and pull requests ssh-key Manage personal SSH keys tag Repository tag lifecycle commands update Check for and install the latest bb release webhook Manage repository webhooks Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) Use "bb [command] --help" for more information about a command. ``` ## `bb admin` Administrative and connectivity checks ```text Administrative and connectivity checks Usage: bb admin [command] Available Commands: health Probe the configured Bitbucket for reachability and authentication Use "bb admin [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb admin health` Probe the configured Bitbucket for reachability and authentication ```text Probe the configured Bitbucket for reachability and authentication. This was previously described as checking "local stack health", which it never did: it probes whichever host BITBUCKET_URL resolves to, wherever that is. The description was wrong, not the command. bb auth status now reports the same thing and more — identity, credential storage, and whether git is set up to authenticate through bb — so prefer that. This stays for scripts that already call it. Usage: bb admin health [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb ai` AI-first tooling: MCP server and agent skill distribution ```text AI-first tooling: MCP server and agent skill distribution Usage: bb ai [command] Available Commands: mcp MCP server commands skill Agent skill distribution commands Use "bb ai [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb ai mcp` MCP server commands ```text MCP server commands Usage: bb ai mcp [command] Available Commands: serve Start the MCP server (stdio transport) tools List available MCP tools with name, exposure and description Use "bb ai mcp [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb ai mcp serve` Start the MCP server (stdio transport) ```text Start the bb MCP server using stdio transport for IDE integration. Configure your IDE's MCP client to run: bb ai mcp serve VS Code (settings.json): "mcp": { "servers": { "bb": { "type": "stdio", "command": "bb", "args": ["ai", "mcp", "serve"] } } } Give the server its own credential through the client's env block, which every MCP client supports -- Claude Code and Claude Desktop (.mcp.json / claude_desktop_config.json), Codex ([mcp_servers.bb.env] in config.toml, or codex mcp add --env), and Antigravity (mcp_config.json): "bb": { "command": "bb", "args": ["ai", "mcp", "serve"], "env": { "BITBUCKET_TOKEN": "${BB_MCP_TOKEN}" } } The ${VAR} form is worth using deliberately: it keeps the agent on a different PAT from your own, so the token you use interactively can carry write rights while the one the agent gets is read-only, and neither is written into the config file. Scoping the server this way replaces the old --token flag, which put the credential in the process argument list for as long as the server ran -- world-readable on Linux, unlike the process environment. By default the server runs in safe mode: only tools whose side-effects are low-blast-radius and easily reversed are exposed (e.g. create_pull_request, add_pr_comment). Tools that perform irreversible operations such as merge_pull_request are withheld unless --yolo is set. Use --tools to expose a specific subset regardless of the safety classification. Use --exclude to suppress individual tools in any mode. When more than one Bitbucket instance is configured the --host flag is required. Use --project or --repo to confine the server to one project or repository. Any tool call aimed elsewhere is refused. Tools that address a resource Bitbucket does not scope to a project — build statuses, which hang off a commit SHA — are withheld entirely while a scope is set, because there is no argument to bound. Confinement applies only when the flags are passed explicitly: the server is never scoped by the repository of the directory it starts in. Use --audit-file to record every tool call as JSON Lines for SIEM collection. Pass a path, or 'stderr' for a containerised deployment whose log collector reads the process streams. Auditing is off by default. When it is on and a record cannot be written the call is refused; --audit-failure=warn relaxes that. The audit trail covers this server only. An agent that can run shell commands can invoke bb directly and bypass it, along with every other control here; the control that survives that is the token itself, which binds at the Bitbucket server -- give this server a narrower PAT than your own through env. Usage: bb ai mcp serve [flags] Flags: --allow-writes Alias for --yolo --audit-failure string What to do when an audit record cannot be written (one of: deny, warn) (default "deny") --audit-file string Append a JSON Lines audit record per tool call to this path, or to 'stderr' --exclude string Comma-separated denylist of tool names to suppress --host string Target Bitbucket instance URL; required when multiple instances are configured --project string Confine the server to this project key; calls aimed elsewhere are refused --repo string Confine the server to one repository, as PROJECT/slug (or a slug alongside --project) --tools string Comma-separated allowlist of tool names to expose (overrides safety filter) --yolo Expose all tools including unsafe operations like merge_pull_request ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb ai mcp tools` List available MCP tools with name, exposure and description ```text Print all MCP tools the serve command can expose. Use this output to build --tools and --exclude allowlists/denylists. EXPOSURE says when a tool is available, and ACCESS whether it changes anything: SAFE exposed by default. Some of these write -- opening a pull request, commenting, tagging -- but none changes a branch or causes a merge YOLO withheld unless 'bb ai mcp serve --yolo' (or --allow-writes) is set, because it cannot be undone, causes a merge, or feeds a check that decides whether one is allowed --tools takes precedence over the safety filter, so naming a YOLO tool in an allowlist exposes it without --yolo. Pass --safe-only to list just the set the server exposes by default. Usage: bb ai mcp tools [flags] Flags: --safe-only List only the tools the server exposes without --yolo ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb ai skill` Agent skill distribution commands ```text Agent skill distribution commands Usage: bb ai skill [command] Available Commands: install Write an agent skill to the agent skills directory remove Remove an installed agent skill file show Print an agent skill to stdout Use "bb ai skill [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb ai skill install` Write an agent skill to the agent skills directory ```text Write an agent skill file to the appropriate directory (defaults to "bb", supports "bulk" / "bb-bulk"). Project scope (default): .agents/skills//SKILL.md Global scope (--global): ~/.agents/skills//SKILL.md The skill is embedded in this binary, so no network connection is required. Re-run after upgrading bb to keep the skill file current. Usage: bb ai skill install [skill] [flags] Flags: --global Install to user-level path (~/.agents/skills//SKILL.md) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb ai skill remove` Remove an installed agent skill file ```text Remove an installed agent skill file Usage: bb ai skill remove [skill] [flags] Flags: --global Remove from user-level path (~/.agents/skills//SKILL.md) -y, --yes Confirm without being asked ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb ai skill show` Print an agent skill to stdout ```text Print an agent skill to stdout (defaults to "bb", supports "bulk" / "bb-bulk"). The skill is embedded in this binary at compile time, so it works with no network connection and without the source repository present. Redirect to the location your coding agent expects: bb ai skill show > .agents/skills/bb/SKILL.md bb ai skill show bulk > .agents/skills/bb-bulk/SKILL.md Most agents use .agents/skills//SKILL.md as the project-scoped path. Some use agent-specific paths (e.g. .claude/skills/, .cursor/skills/). Consult your agent's documentation if the above path does not work. Baseline skills (fixed at release time) are also distributed via the open agent skills ecosystem and can be installed without bb being present: npx skills add vriesdemichael/bitbucket-data-center-cli The npx-installed files are snapshots from the repository. Use this command to get a skill that always matches your installed bb version. Usage: bb ai skill show [skill] [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb api` Send a raw HTTP request to the Bitbucket REST API ```text Send a raw HTTP request to the Bitbucket REST API as an escape hatch for uncovered endpoints. Reuses stored authentication, host aliases, TLS options, retries, and pagination. Field arguments: -f, --raw-field k=v Pass a string parameter (query parameter for GET, JSON field for POST/PUT/DELETE) -F, --field k=v Pass a typed parameter (parses booleans, numbers, null, JSON, or @file) -H, --header k:v Pass a custom HTTP header --input file Pass a request body from a file (or '-' for stdin) --paginate Automatically fetch all pages for paginated endpoints --host url Target a specific Bitbucket host URL Note: On Windows Git Bash (MSYS2), set MSYS_NO_PATHCONV=1 or omit the leading slash (e.g. rest/api/1.0/...) to prevent shell path mangling. Usage: bb api [flags] Examples: # GET a pull request settings resource bb api /rest/api/1.0/projects/PROJ/repos/repo/settings/pull-requests # Target a specific Bitbucket instance bb api /rest/api/1.0/projects --host https://bitbucket.example.com # Paginate all admin groups bb api /rest/api/1.0/admin/groups --paginate # POST with typed JSON body fields bb api /rest/api/1.0/projects/PROJ/repos/repo/branches -X POST -F name=feature/test -F startPoint=main # POST with JSON payload from file or stdin bb api /rest/api/1.0/projects/PROJ/repos/repo/branches --method POST --input body.json cat body.json | bb api /rest/api/1.0/projects/PROJ/repos/repo/branches -X POST --input - Flags: -F, --field stringArray Add a typed parameter (key=value, booleans, numbers, null, or @file) -H, --header stringArray Add a custom HTTP request header (Name: Value) --host string Bitbucket host URL --input string File to use as request body (or '-' for stdin) -X, --method string HTTP method (one of: GET, POST, PUT, DELETE, PATCH, HEAD) --paginate Automatically fetch all pages for paginated endpoints -f, --raw-field stringArray Add a string parameter (key=value) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb auth` Authentication commands ```text Authentication commands Usage: bb auth [command] Available Commands: alias Manage host aliases for a stored server context git-credential Git credential helper (invoked by git, not run directly) gpg-key Manage personal GPG keys identity Show authenticated user identity login Store credentials for a Bitbucket host logout Remove stored credentials for a Bitbucket host server Manage server contexts setup-git Configure git to authenticate to Bitbucket through bb status Show the configured target and verify it works token Manage HTTP access tokens token-url Show personal access token creation URL Use "bb auth [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb auth alias` Manage host aliases for a stored server context ```text Manage host aliases for a stored server context Usage: bb auth alias [command] Available Commands: add Add aliases to a stored server context discover Discover aliases from the first accessible repository clone links list List aliases for a stored server context remove Remove an alias from a stored server context Use "bb auth alias [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb auth alias add` Add aliases to a stored server context ```text Add aliases to a stored server context Usage: bb auth alias add [alias...] [flags] Flags: --host string Bitbucket host URL ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb auth alias discover` Discover aliases from the first accessible repository clone links ```text Discover aliases from the first accessible repository clone links. Discovered aliases are added to the ones already stored. Aliases added by hand are kept, because discovery cannot find every alias -- an instance whose SSH clone host differs from its web URL is the documented case for adding one manually, and it would be undone by every later discovery run. Pass --replace to store only what was discovered. Anything dropped is named in the output. Usage: bb auth alias discover [flags] Flags: --host string Bitbucket host URL --replace Store only the discovered aliases, dropping any others ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb auth alias list` List aliases for a stored server context ```text List aliases for a stored server context Usage: bb auth alias list [flags] Flags: --host string Bitbucket host URL ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb auth alias remove` Remove an alias from a stored server context ```text Remove an alias from a stored server context Usage: bb auth alias remove [flags] Flags: --host string Bitbucket host URL -y, --yes Confirm without being asked ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb auth git-credential` Git credential helper (invoked by git, not run directly) ```text Supply stored Bitbucket credentials to git on demand. git invokes this; you do not normally run it yourself. Configure it with: bb auth setup-git Credentials are read from the same place `bb auth login` stores them, so git and bb stay in agreement and no token is ever written into a repository. Usage: bb auth git-credential [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb auth gpg-key` Manage personal GPG keys ```text Manage personal GPG keys Usage: bb auth gpg-key [command] Available Commands: add Add a personal GPG key clear Clear all personal GPG keys list List personal GPG keys remove Remove a personal GPG key Use "bb auth gpg-key [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb auth gpg-key add` Add a personal GPG key ```text Add a personal GPG key Usage: bb auth gpg-key add [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb auth gpg-key clear` Clear all personal GPG keys ```text Clear all personal GPG keys Usage: bb auth gpg-key clear [flags] Flags: -y, --yes Confirm clearing of all GPG keys ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb auth gpg-key list` List personal GPG keys ```text List personal GPG keys Usage: bb auth gpg-key list [flags] Flags: --all Return every result rather than the first --limit --limit int Maximum number of results to return (default 25) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb auth gpg-key remove` Remove a personal GPG key ```text Remove a personal GPG key Usage: bb auth gpg-key remove [flags] Flags: -y, --yes Confirm without being asked ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb auth identity` Show authenticated user identity ```text Show authenticated user identity Usage: bb auth identity [flags] Aliases: identity, whoami Flags: --host string Override host for this identity check ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb auth login` Store credentials for a Bitbucket host ```text Store credentials for a Bitbucket host. Prefer the stdin forms. A secret passed as a flag value appears in the process argument list, where any local user can read it through ps or /proc, and where the shell records it in history: printf '%s' "$BITBUCKET_TOKEN" | bb auth login https://bitbucket.example.com --token-stdin Credentials are stored in the OS keyring. Where no keyring is available — headless servers, most containers, WSL without gnome-keyring — bb falls back to the config file in plaintext and says so. Pass --require-keyring (or set BB_REQUIRE_KEYRING=1) to fail instead of falling back. Usage: bb auth login [flags] Flags: --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --discover-aliases Discover host aliases from the first accessible repository clone links (default true) --password-stdin Read the basic-auth password from stdin --require-keyring Fail if the OS keyring is unavailable instead of storing credentials in plaintext --set-default Set host as default target (default true) --token-stdin Read the access token from stdin --username string Username for basic auth ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb auth logout` Remove stored credentials for a Bitbucket host ```text Remove stored credentials for a Bitbucket host Usage: bb auth logout [flags] Flags: --host string Bitbucket host URL (defaults to stored default host) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb auth server` Manage server contexts ```text Manage server contexts Usage: bb auth server [command] Available Commands: list List stored server contexts use Set the active default server context Use "bb auth server [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb auth server list` List stored server contexts ```text List stored server contexts Usage: bb auth server list [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb auth server use` Set the active default server context ```text Set the active default server context Usage: bb auth server use [host] [flags] Flags: --host string Bitbucket host URL ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb auth setup-git` Configure git to authenticate to Bitbucket through bb ```text Configure git to ask bb for Bitbucket credentials. This replaces the need to embed credentials in a repository or in a remote URL. The configuration is scoped to the Bitbucket host, so git never offers these credentials to any other remote. Usage: bb auth setup-git [flags] Flags: --force Overwrite an existing credential helper for this host --global Write to global git config rather than the current repository (default true) --host string Bitbucket host URL (defaults to the configured host) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb auth status` Show the configured target and verify it works ```text Show the configured target and verify it works. Reports the resolved host, how the credential is stored, whether that credential still authenticates, and whether git is set up to authenticate through bb. Reporting alone is not enough to be useful: an expired token, an unreachable host and a working setup used to produce the same confident output. Each line now says which it is, and what to do when it is not the last one. Lines marked ! are advisory: they report something worth knowing that does not mean the setup is broken. The git credential helper is one — it is needed to git push and irrelevant to anything that only calls the API — so it is reported but never fails the command. Exit status is unchanged by default, so existing scripts keep working. Pass --check to exit non-zero when a non-advisory check fails, which is the form worth putting in CI. Under --json the exit status is always zero and the verdict is the "ok" field. Machine output is a single document on stdout, so a failing exit would replace the findings with an error envelope — losing exactly the detail that was asked for. Usage: bb auth status [flags] Flags: --check Exit non-zero when a check fails (for CI) --host string Override host for this status check ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb auth token` Manage HTTP access tokens ```text Manage HTTP access tokens Usage: bb auth token [command] Available Commands: create Create an HTTP access token get Get an HTTP access token by ID list List HTTP access tokens revoke Revoke an HTTP access token by ID update Update an HTTP access token name or permissions Flags: --project string Project key for project access token scope --repo string Repository reference (projectKey/repositorySlug) for repository access token scope --user string User slug for personal access token scope Use "bb auth token [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb auth token create` Create an HTTP access token ```text Create an HTTP access token Usage: bb auth token create [name] [flags] Flags: --expiry-days int Number of days before the token expires (0 for never) --name string Name of the access token --permission strings Permissions to grant (repeat flag or separate with commas) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --project string Project key for project access token scope --repo string Repository reference (projectKey/repositorySlug) for repository access token scope --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) --user string User slug for personal access token scope ``` ## `bb auth token get` Get an HTTP access token by ID ```text Get an HTTP access token by ID Usage: bb auth token get [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --project string Project key for project access token scope --repo string Repository reference (projectKey/repositorySlug) for repository access token scope --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) --user string User slug for personal access token scope ``` ## `bb auth token list` List HTTP access tokens ```text List HTTP access tokens Usage: bb auth token list [flags] Flags: --all Return every result rather than the first --limit --limit int Maximum number of results to return (default 25) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --project string Project key for project access token scope --repo string Repository reference (projectKey/repositorySlug) for repository access token scope --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) --user string User slug for personal access token scope ``` ## `bb auth token revoke` Revoke an HTTP access token by ID ```text Revoke an HTTP access token by ID Usage: bb auth token revoke [flags] Flags: -y, --yes Confirm without being asked ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --project string Project key for project access token scope --repo string Repository reference (projectKey/repositorySlug) for repository access token scope --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) --user string User slug for personal access token scope ``` ## `bb auth token update` Update an HTTP access token name or permissions ```text Update an HTTP access token name or permissions Usage: bb auth token update [flags] Flags: --name string New name for the access token --permission strings New permissions to set (repeat flag or separate with commas) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --project string Project key for project access token scope --repo string Repository reference (projectKey/repositorySlug) for repository access token scope --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) --user string User slug for personal access token scope ``` ## `bb auth token-url` Show personal access token creation URL ```text Show personal access token creation URL Usage: bb auth token-url [flags] Flags: --host string Bitbucket host URL ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb branch` Repository branch and branch restriction commands ```text Repository branch and branch restriction commands Usage: bb branch [command] Available Commands: create Create repository branch default Get or set repository default branch delete Delete repository branch list List repository branches model Inspect and update branch model-related settings restriction Manage repository branch restrictions Flags: --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --start int Start offset for list operations Use "bb branch [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb branch create` Create repository branch ```text Create repository branch Usage: bb branch create [flags] Flags: --start-point string Commit ID or ref to branch from ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) --start int Start offset for list operations ``` ## `bb branch default` Get or set repository default branch ```text Get or set repository default branch Usage: bb branch default [command] Available Commands: get Get repository default branch set Set repository default branch Use "bb branch default [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) --start int Start offset for list operations ``` ## `bb branch default get` Get repository default branch ```text Get repository default branch Usage: bb branch default get [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) --start int Start offset for list operations ``` ## `bb branch default set` Set repository default branch ```text Set repository default branch Usage: bb branch default set [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) --start int Start offset for list operations ``` ## `bb branch delete` Delete repository branch ```text Delete repository branch Usage: bb branch delete [flags] Flags: --end-point string Expected commit at branch tip -y, --yes Confirm without being asked ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) --start int Start offset for list operations ``` ## `bb branch list` List repository branches ```text List repository branches Usage: bb branch list [flags] Flags: --all Return every result rather than the first --limit --base string Base ref filter --details Include branch details from Bitbucket --filter string Filter text for branch names --limit int Maximum number of results to return (default 25) --order-by string Branch ordering (one of: ALPHABETICAL, MODIFICATION) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) --start int Start offset for list operations ``` ## `bb branch model` Inspect and update branch model-related settings ```text Inspect and update branch model-related settings Usage: bb branch model [command] Available Commands: inspect Show the branch a commit belongs to update Update repository default branch used by branch model settings Use "bb branch model [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) --start int Start offset for list operations ``` ## `bb branch model inspect` Show the branch a commit belongs to ```text Show the branch a commit belongs to Usage: bb branch model inspect [flags] Flags: --all Return every result rather than the first --limit --limit int Maximum number of results to return (default 25) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) --start int Start offset for list operations ``` ## `bb branch model update` Update repository default branch used by branch model settings ```text Update repository default branch used by branch model settings Usage: bb branch model update [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) --start int Start offset for list operations ``` ## `bb branch restriction` Manage repository branch restrictions ```text Manage repository branch restrictions Usage: bb branch restriction [command] Available Commands: create Create branch restriction delete Delete branch restriction get Get branch restriction by id list List branch restrictions update Update branch restriction Use "bb branch restriction [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) --start int Start offset for list operations ``` ## `bb branch restriction create` Create branch restriction ```text Create branch restriction Usage: bb branch restriction create [flags] Flags: --access-key-id ints SSH access key id allowed by restriction (repeatable) --group strings Group name allowed by restriction (repeatable) --matcher-display string Matcher display value --matcher-id string Matcher id value --matcher-type string Matcher type (one of: BRANCH, MODEL_BRANCH, MODEL_CATEGORY, PATTERN) (default "BRANCH") --type string Restriction type (one of: read-only, no-deletes, fast-forward-only, pull-request-only, no-creates) --user strings User slug allowed by restriction (repeatable) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) --start int Start offset for list operations ``` ## `bb branch restriction delete` Delete branch restriction ```text Delete branch restriction Usage: bb branch restriction delete [flags] Flags: -y, --yes Confirm without being asked ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) --start int Start offset for list operations ``` ## `bb branch restriction get` Get branch restriction by id ```text Get branch restriction by id Usage: bb branch restriction get [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) --start int Start offset for list operations ``` ## `bb branch restriction list` List branch restrictions ```text List branch restrictions Usage: bb branch restriction list [flags] Flags: --all Return every result rather than the first --limit --limit int Maximum number of results to return (default 25) --matcher-id string Matcher id value --matcher-type string Matcher type (one of: BRANCH, MODEL_BRANCH, MODEL_CATEGORY, PATTERN) --type string Restriction type (one of: read-only, no-deletes, fast-forward-only, pull-request-only, no-creates) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) --start int Start offset for list operations ``` ## `bb branch restriction update` Update branch restriction ```text Update branch restriction Usage: bb branch restriction update [flags] Flags: --access-key-id ints SSH access key id allowed by restriction (repeatable) --group strings Group name allowed by restriction (repeatable) --matcher-display string Matcher display value --matcher-id string Matcher id value --matcher-type string Matcher type (one of: BRANCH, MODEL_BRANCH, MODEL_CATEGORY, PATTERN) --type string Restriction type (one of: read-only, no-deletes, fast-forward-only, pull-request-only, no-creates) --user strings User slug allowed by restriction (repeatable) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) --start int Start offset for list operations ``` ## `bb browse` Open repository pages in a web browser ```text Open repository pages in a web browser Usage: bb browse [ | | ] [flags] Flags: --blame Open blame view for a file -b, --branch string Select another branch -c, --commit string Select another commit -n, --no-browser Print destination URL instead of opening the browser -r, --releases Open repository tags/releases view -R, --repo string Repository as [HOST/]PROJECT/slug (defaults to inferred repository context) -s, --settings Open repository settings ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb build` Build status and required merge-check commands ```text Build status and required merge-check commands Usage: bb build [command] Available Commands: delete Delete repository-scoped build status by key get Get repository-scoped build status by key required Required build merge-check management set Set repository-scoped build status for a commit status Build status commands by commit Flags: --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) Use "bb build [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb build delete` Delete repository-scoped build status by key ```text Delete repository-scoped build status by key Usage: bb build delete [flags] Flags: --key string Build status key -y, --yes Confirm without being asked ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb build get` Get repository-scoped build status by key ```text Get repository-scoped build status by key Usage: bb build get [flags] Flags: --key string Build status key ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb build required` Required build merge-check management ```text Required build merge-check management Usage: bb build required [command] Available Commands: create Create required build merge check delete Delete required build merge check list List required build merge checks update Update required build merge check Use "bb build required [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb build required create` Create required build merge check ```text Create required build merge check Usage: bb build required create [flags] Flags: --body string Raw JSON payload for required build merge check ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb build required delete` Delete required build merge check ```text Delete required build merge check Usage: bb build required delete [flags] Flags: --all Return every result rather than the first --limit --limit int Maximum number of results to return (default 25) -y, --yes Confirm without being asked ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb build required list` List required build merge checks ```text List required build merge checks Usage: bb build required list [flags] Flags: --all Return every result rather than the first --limit --limit int Maximum number of results to return (default 25) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb build required update` Update required build merge check ```text Update required build merge check Usage: bb build required update [flags] Flags: --body string Raw JSON payload for required build merge check ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb build set` Set repository-scoped build status for a commit ```text Set repository-scoped build status for a commit Usage: bb build set [flags] Flags: --build-number string Build number --description string Build description --duration-ms int Duration in milliseconds --key string Build status key --name string Build display name --parent string Build parent key --ref string Build ref --state string Build state (one of: SUCCESSFUL, FAILED, INPROGRESS, CANCELLED, UNKNOWN) --url string Build URL ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb build status` Build status commands by commit ```text Build status commands by commit Usage: bb build status [command] Available Commands: get Get build statuses for a commit set Set build status for a commit stats Get build status summary counts for one or more commits Flags: --include-unique Include unique result details when available Use "bb build status [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb build status get` Get build statuses for a commit ```text Get build statuses for a commit Usage: bb build status get [flags] Flags: --all Return every result rather than the first --limit --limit int Maximum number of results to return (default 25) --order-by string Build status ordering (one of: NEWEST, OLDEST, STATUS) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --include-unique Include unique result details when available --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb build status set` Set build status for a commit ```text Set build status for a commit Usage: bb build status set [flags] Flags: --build-number string Build number --description string Build description --duration-ms int Duration in milliseconds --key string Build status key --name string Build display name --parent string Build parent key --ref string Build ref --state string Build state (one of: SUCCESSFUL, FAILED, INPROGRESS, CANCELLED, UNKNOWN) --url string Build URL ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --include-unique Include unique result details when available --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb build status stats` Get build status summary counts for one or more commits ```text Get build status summary counts for one or more commits Usage: bb build status stats ... [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --include-unique Include unique result details when available --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb bulk` Plan and apply multi-repository policies (deprecated) ```text Plan and apply multi-repository policies (deprecated) Usage: bb bulk [command] Available Commands: apply Apply operations from a reviewed bulk plan plan Resolve a bulk policy into a deterministic reviewed plan status Show the saved status for a prior bulk apply operation Use "bb bulk [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb bulk apply` Apply operations from a reviewed bulk plan ```text Apply operations from a reviewed bulk plan Usage: bb bulk apply [flags] Flags: --from-plan string Path to reviewed bulk plan JSON file ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb bulk plan` Resolve a bulk policy into a deterministic reviewed plan ```text Resolve a bulk policy into a deterministic reviewed plan Usage: bb bulk plan [flags] Flags: -f, --file string Path to bulk policy YAML file -o, --output string Optional path to write the reviewed plan JSON artifact ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb bulk status` Show the saved status for a prior bulk apply operation ```text Show the saved status for a prior bulk apply operation Usage: bb bulk status [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb clone` Clone a repository to the local filesystem ```text Clone a repository to the local filesystem Usage: bb clone [directory] [-- ...] [flags] Flags: --https Use HTTPS only and skip the SSH clone attempt --no-upstream Do not add an upstream remote when cloning a fork --ssh Use SSH only and disable HTTPS fallback -u, --upstream-remote-name string Upstream remote name when cloning a fork (default "upstream") ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb commit` Commit inspection and compare commands ```text Commit inspection and compare commands Usage: bb commit [command] Available Commands: compare Compare two commits or refs get Get a specific commit list List repository commits prs List pull requests containing a commit Flags: --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --start int Start offset for list operations Use "bb commit [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb commit compare` Compare two commits or refs ```text List the commits reachable from but not from : what has that lacks. Pass the ref you are asking about first; git log's range puts it last. bb commit compare feature/x main # commits feature/x adds bb commit compare # commits since the last green build Usage: bb commit compare [flags] Flags: --all Return every result rather than the first --limit --limit int Maximum number of results to return (default 25) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) --start int Start offset for list operations ``` ## `bb commit get` Get a specific commit ```text Get a specific commit Usage: bb commit get [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) --start int Start offset for list operations ``` ## `bb commit list` List repository commits ```text List repository commits Usage: bb commit list [flags] Flags: --all Return every result rather than the first --limit --jira string List commits associated with a Jira issue key --limit int Maximum number of results to return (default 25) --path string Filter commits by file path ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) --start int Start offset for list operations ``` ## `bb commit prs` List pull requests containing a commit ```text List pull requests containing a commit Usage: bb commit prs [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) --start int Start offset for list operations ``` ## `bb deployment` Manage repository-scoped deployments for commits ```text Manage repository-scoped deployments for commits Usage: bb deployment [command] Available Commands: create Create or update a repository-scoped deployment for a commit delete Delete repository-scoped deployment for a commit get Get repository-scoped deployment details for a commit Flags: --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) Use "bb deployment [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb deployment create` Create or update a repository-scoped deployment for a commit ```text Create or update a repository-scoped deployment for a commit Usage: bb deployment create [flags] Flags: --deployment-sequence-number int Sequence number of the deployment --description string Description of the deployment --display-name string Display name of the deployment --env-key string Environment key --env-name string Environment display name --env-type string Environment type (one of: PRODUCTION, STAGING, TESTING, DEVELOPMENT, UNKNOWN) --env-url string Environment URL --key string Deployment key --state string Deployment state (one of: PENDING, IN_PROGRESS, SUCCESSFUL, FAILED, CANCELLED, ROLLED_BACK, UNKNOWN) --url string Deployment URL ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb deployment delete` Delete repository-scoped deployment for a commit ```text Delete repository-scoped deployment for a commit Usage: bb deployment delete [flags] Flags: --deployment-sequence-number string Identify by deployment sequence number --env-key string Identify by environment key --key string Identify by deployment key -y, --yes Confirm without being asked ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb deployment get` Get repository-scoped deployment details for a commit ```text Get repository-scoped deployment details for a commit Usage: bb deployment get [flags] Flags: --deployment-sequence-number string Filter by deployment sequence number --env-key string Filter by environment key --key string Filter by deployment key ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb diff` Diff and patch commands ```text Diff and patch commands Usage: bb diff [command] Available Commands: commit Diff a commit against its parent pr Diff a pull request refs Diff two refs or commits Flags: --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) Use "bb diff [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb diff commit` Diff a commit against its parent ```text Diff a commit against its parent Usage: bb diff commit [flags] Flags: --path string Optional file path for file-scoped diff ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb diff pr` Diff a pull request ```text Diff a pull request. Also available as bb pr diff, which is the gh spelling. Usage: bb diff pr [flags] Flags: --name-only Output only changed file names --patch Output unified patch stream --stat Output structured diff stats ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb diff refs` Diff two refs or commits ```text Diff two refs or commits Usage: bb diff refs [flags] Flags: --name-only Output only changed file names --patch Output unified patch stream --path string Optional file path for file-scoped diff --stat Output structured diff stats ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb doctor` Check the configuration bb would load ```text Check the configuration bb would load, and report everything wrong with it at once. A command that loads the configuration stops at the first file it cannot use. bb doctor reads the stored, workspace and system configuration files on their own and reports, for each, where it is, whether it parses, and every key the configuration schema rejects, with its line. It lists keys that are valid but not read from the file they are in: policy set in your own file mandates nothing. It then shows where each effective setting comes from -- a flag, an environment variable, a .env file, a configuration file, the Windows registry or the built-in default -- and what it overrides. When keyring-backed storage is required, it checks that the OS keyring can be reached. It needs no configured host, never contacts Bitbucket, and never prints a secret: a token or password is reported as configured, with where it is held. Exit status is 0 only when there is nothing to fix. Any issue the report shows -- an invalid file, a key its file never reads, a setting a command would refuse, a required keyring that cannot be reached -- exits 1. Under --json a run with issues writes the failure envelope instead of the report: its message summarises the issues, and error.details names each one under its own key, file/, violation//, ignored//, setting/ or keyring, with the key path written as a JSON Pointer. Usage: bb doctor [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb insights` Code Insights report and annotation commands ```text Code Insights report and annotation commands Usage: bb insights [command] Available Commands: annotation Code Insights annotation commands report Code Insights report commands Flags: --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) Use "bb insights [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb insights annotation` Code Insights annotation commands ```text Code Insights annotation commands Usage: bb insights annotation [command] Available Commands: add Add annotations to a Code Insights report delete Delete annotation(s) by external id for a report list List annotations for a Code Insights report or commit set Create or replace a Code Insights report annotation Use "bb insights annotation [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb insights annotation add` Add annotations to a Code Insights report ```text Add annotations to a Code Insights report Usage: bb insights annotation add [flags] Flags: --body string Raw JSON array payload for annotations ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb insights annotation delete` Delete annotation(s) by external id for a report ```text Delete annotation(s) by external id for a report Usage: bb insights annotation delete [flags] Flags: --external-id string External annotation ID to delete -y, --yes Confirm without being asked ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb insights annotation list` List annotations for a Code Insights report or commit ```text List annotations for a Code Insights report or commit Usage: bb insights annotation list [key] [flags] Flags: --all Return every result rather than the first --limit --limit int Maximum number of results to return (default 25) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb insights annotation set` Create or replace a Code Insights report annotation ```text Create or replace a Code Insights report annotation Usage: bb insights annotation set [flags] Flags: --line int32 Line number containing the annotation --link string Link associated with the annotation --message string Annotation message --path string File path containing the annotation --severity string Annotation severity (one of: LOW, MEDIUM, HIGH) --type string Annotation type (one of: BUG, CODE_SMELL, VULNERABILITY) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb insights report` Code Insights report commands ```text Code Insights report commands Usage: bb insights report [command] Available Commands: delete Delete a Code Insights report get Get a Code Insights report list List Code Insights reports for a commit set Create or update a Code Insights report Use "bb insights report [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb insights report delete` Delete a Code Insights report ```text Delete a Code Insights report Usage: bb insights report delete [flags] Flags: -y, --yes Confirm without being asked ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb insights report get` Get a Code Insights report ```text Get a Code Insights report Usage: bb insights report get [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb insights report list` List Code Insights reports for a commit ```text List Code Insights reports for a commit Usage: bb insights report list [flags] Flags: --all Return every result rather than the first --limit --limit int Maximum number of results to return (default 25) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb insights report set` Create or update a Code Insights report ```text Create or update a Code Insights report Usage: bb insights report set [flags] Flags: --body string Raw JSON payload for Code Insights report ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr` Pull request commands ```text Pull request commands Usage: bb pr [command] Available Commands: activity Pull request activity commands auto-merge Pull request auto-merge commands (Bitbucket DC 8.0+) build Pull request build status commands checkout Check out a pull request branch locally checks Show build statuses for a pull request's source commit (alias for bb pr build status) comment Pull request comment commands commits List the commits in a pull request create Create a pull request decline Decline a pull request default-reviewers List default reviewers and matching conditions for repository diff Diff a pull request (alias for bb diff pr) files List the files changed in a pull request get Get pull request details, including outstanding review feedback jira List Jira issues associated with a pull request list List pull requests merge Merge a pull request merge-base Show the common ancestor commit of a pull request's source and target branches participants Search pull request participants across a repository ready Mark a draft pull request ready for review, or turn it back into a draft rebase Rebase a pull request reopen Reopen a pull request review Pull request review commands status Show pull requests waiting on you unwatch Unwatch a pull request update Update pull request metadata watch Watch a pull request Flags: --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) Use "bb pr [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr activity` Pull request activity commands ```text Pull request activity commands. This is an explicit exception to the stable versioned API and is intended only for AI ingestion and debugging. Usage: bb pr activity [command] Available Commands: list List raw pull request activity items Use "bb pr activity [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr activity list` List raw pull request activity items ```text List raw pull request activity items. This output is an explicit exception to the stable versioned API and is intended only for AI ingestion and debugging. Usage: bb pr activity list [flags] Flags: --all Return every result rather than the first --limit --limit int Maximum number of results to return (default 25) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr auto-merge` Pull request auto-merge commands (Bitbucket DC 8.0+) ```text Pull request auto-merge commands (Bitbucket DC 8.0+) Usage: bb pr auto-merge [command] Available Commands: disable Disable auto-merge on a pull request enable Enable auto-merge on a pull request get Get auto-merge configuration for a pull request Use "bb pr auto-merge [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr auto-merge disable` Disable auto-merge on a pull request ```text Disable auto-merge on a pull request Usage: bb pr auto-merge disable [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr auto-merge enable` Enable auto-merge on a pull request ```text Enable auto-merge on a pull request Usage: bb pr auto-merge enable [flags] Examples: # Enable auto-merge with the default strategy (no-ff) bb pr auto-merge enable 42 --repo PROJ/repo # Enable auto-merge with a specific strategy bb pr auto-merge enable 42 --repo PROJ/repo --strategy rebase-ff-only Flags: --strategy string Merge strategy (one of: no-ff, ff, ff-only, rebase-no-ff, rebase-ff-only, squash, squash-ff-only) (default "no-ff") ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr auto-merge get` Get auto-merge configuration for a pull request ```text Get auto-merge configuration for a pull request Usage: bb pr auto-merge get [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr build` Pull request build status commands ```text Pull request build status commands Usage: bb pr build [command] Available Commands: status Show build statuses for a pull request's source commit (also available as bb pr checks) Use "bb pr build [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr build status` Show build statuses for a pull request's source commit (also available as bb pr checks) ```text Show build statuses for a pull request's source commit (also available as bb pr checks) Usage: bb pr build status [flags] Flags: --all Return every result rather than the first --limit --limit int Maximum number of results to return (default 25) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr checkout` Check out a pull request branch locally ```text Check out the source branch of a pull request in the current git repository. Same-repository pull requests are checked out from the remote that already points at the repository. Pull requests from a fork fetch from the fork, adding a remote for it when one is not configured yet, so a later git push goes back to the fork branch the pull request is built from. The fetch uses the credentials bb is already authenticated with, so no git credential setup is needed first. Pushing afterwards is plain git and does need one: run bb auth setup-git once. Usage: bb pr checkout [flags] Flags: --branch string Local branch name to use (defaults to the pull request source branch) --detach Check out the source commit without creating or moving a local branch --force Check out even when tracked files have uncommitted changes, discarding them ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr checks` Show build statuses for a pull request's source commit (alias for bb pr build status) ```text Show build statuses for a pull request's source commit (alias for bb pr build status) Usage: bb pr checks [flags] Flags: --all Return every result rather than the first --limit --limit int Maximum number of results to return (default 25) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr comment` Pull request comment commands ```text Pull request comment commands Usage: bb pr comment [command] Available Commands: add Add a comment to a pull request apply-suggestion Apply a suggested change from a comment get Get a pull request comment list List comment threads for a pull request, unresolved first react Add or remove a reaction on a pull request comment reopen Reopen a resolved pull request comment resolve Resolve a pull request comment, closing it as a task Use "bb pr comment [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr comment add` Add a comment to a pull request ```text Add a comment to a pull request. Pass --path and --line to anchor the comment to a file and line, or --parent-id to reply to an existing comment. Bitbucket only accepts an anchor on a line that appears in the pull request diff, so the line has to be inside a changed hunk and --line-type has to match the side it is on. Usage: bb pr comment add [flags] Examples: # A pull-request-level comment bb pr comment add 49 --repo PROJ/repo --text "Looks good overall." # Anchored to a line in the diff bb pr comment add 49 --repo PROJ/repo --path app/core/runner.py --line 157 \ --text "This raises after the execution is recorded." # A line that only exists in the original file bb pr comment add 49 --repo PROJ/repo --path app/core/runner.py --line 88 \ --line-type REMOVED --text "Why was this dropped?" # Reply to an existing comment bb pr comment add 49 --repo PROJ/repo --parent-id 1389396 --text "Agreed, fixed." Flags: --blocker Mark the comment as a blocker --line int Line number for an inline comment --line-type string Line type for an inline comment, ADDED when not given (one of: ADDED, REMOVED, CONTEXT) --parent-id int Parent comment ID to reply to --path string File path for an inline comment --pending Mark the comment as pending (draft) --text string Comment text ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr comment apply-suggestion` Apply a suggested change from a comment ```text Apply a suggested change from a comment Usage: bb pr comment apply-suggestion [flags] Flags: --comment-version int32 Optional expected version of the comment --commit-message string Commit message for the applied suggestion (default: names the comment) --index int32 Optional index of the suggestion in the comment (default 0) --pr-version int32 Optional expected version of the pull request ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr comment get` Get a pull request comment ```text Get a single pull request comment by id. This is the authoritative single-comment view and is better suited than list output when you need the full rendered comment payload. Usage: bb pr comment get [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr comment list` List comment threads for a pull request, unresolved first ```text List pull request comment threads. Bitbucket models a task as a blocker comment, so this returns reviewer comments and tasks in one view, each with its resolution state, anchor and reply count. Without --path this uses the pull request activity timeline to return the aggregate comment view. With --path it uses the path-scoped comments endpoint. With --blocker it lists blocker comments. Use --unresolved to show only threads still waiting on someone. Use --full to add every comment ungrouped, alongside the thread view rather than in place of it. Usage: bb pr comment list [flags] Flags: --all Return every result rather than the first --limit --blocker List pull request blocker comments --full Add every comment ungrouped, alongside the thread view --limit int Maximum number of results to return (default 25) --path string Optional file path for path-scoped pull request comment listing --state string Filter threads by resolution state (one of: open, unresolved, resolved, pending, all) (default "all") --tasks-only Show only threads Bitbucket tracks as tasks (blocker comments) --unresolved Show only unresolved threads (shorthand for --state open) --with-replies Include the full text of every reply instead of only the most recent one ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr comment react` Add or remove a reaction on a pull request comment ```text Add or remove a reaction on a pull request comment Usage: bb pr comment react [flags] Flags: --remove Remove the reaction instead of adding it ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr comment reopen` Reopen a resolved pull request comment ```text Reopen a resolved pull request comment Usage: bb pr comment reopen [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr comment resolve` Resolve a pull request comment, closing it as a task ```text Resolve a pull request comment, closing it as a task Usage: bb pr comment resolve [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr commits` List the commits in a pull request ```text List the commits in a pull request Usage: bb pr commits [flags] Flags: --all Return every result rather than the first --limit --limit int Maximum number of results to return (default 25) --start int Start offset for the pull request commit listing ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr create` Create a pull request ```text Create a pull request Usage: bb pr create [flags] Examples: # Create a pull request (automatically includes default reviewers and CODEOWNERS) bb pr create --repo PROJ/repo --from-ref feature/x --to-ref main --title "My change" # Create a draft pull request (Bitbucket DC 8.0+) bb pr create --repo PROJ/repo --from-ref feature/x --to-ref main --title "My change" --draft # Create a pull request and assign explicit reviewers (repeatable or comma-separated) bb pr create --repo PROJ/repo --from-ref feature/x --to-ref main --title "My change" --reviewers alice,bob # Create a pull request with reviewers and reviewer groups bb pr create --repo PROJ/repo --from-ref feature/x --to-ref main --title "My change" --reviewers alice,@backend-team --reviewer-group qa-team # Create a pull request without default reviewers or CODEOWNERS bb pr create --repo PROJ/repo --from-ref feature/x --to-ref main --title "My change" --no-default-reviewers --no-codeowners Flags: --codeowners Assign the code owners Bitbucket reports for the change, the same ones the web interface offers; the CODEOWNERS syntax and its meaning are the server's (default true) --default-reviewers Include default reviewers configured on repository/project; a failed lookup warns, unless this flag is passed explicitly, which makes it fatal (default true) --description string Pull request description --draft Create as a draft pull request (Bitbucket DC 8.0+) --from-ref string Source branch (name or refs/heads/name) --from-repo string Repository holding --from-ref as PROJECT/slug, for a fork to upstream pull request (defaults to --repo) --no-codeowners Do not assign code owners --no-default-reviewers Do not include default reviewers --reviewer-group strings Reviewer group name(s) to expand and add (repeatable or comma-separated; a leading @ and a reviewer-group/ prefix are both accepted; alias --reviewer-groups) --reviewers strings Reviewer usernames to add (repeatable or comma-separated, accepts @group syntax, e.g. --reviewers alice,@backend-team) --title string Pull request title --to-ref string Target branch (name or refs/heads/name) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr decline` Decline a pull request ```text Decline a pull request Usage: bb pr decline [flags] Aliases: decline, close Flags: --version int Expected pull request version; omit to act on whatever version is current ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr default-reviewers` List default reviewers and matching conditions for repository ```text List default reviewers and matching conditions for repository Usage: bb pr default-reviewers [flags] Flags: --source-ref string The ID of the source ref (e.g. refs/heads/feature) --source-repo-id string The ID of the repository in which the source ref exists --target-ref string The ID of the target ref (e.g. refs/heads/master) --target-repo-id string The ID of the repository in which the target ref exists ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr diff` Diff a pull request (alias for bb diff pr) ```text Diff a pull request. Alias for bb diff pr, which is where the command reference documents it. Usage: bb pr diff [flags] Flags: --name-only Output only changed file names --patch Output unified patch stream --stat Output structured diff stats ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr files` List the files changed in a pull request ```text List the files changed in a pull request Usage: bb pr files [flags] Aliases: files, changes Flags: --all Return every result rather than the first --limit --limit int Maximum number of results to return (default 25) --start int Start offset for the pull request change listing ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr get` Get pull request details, including outstanding review feedback ```text Get pull request details. The output carries a review summary describing unresolved comment threads, open tasks and reviewers who requested changes, so outstanding feedback is visible without a separate lookup. The unresolved thread counts come from the activity timeline, which is paged through; pass --no-review-summary to skip it. When the timeline is unavailable the summary falls back to the blocker-comment tally, then to the counters Bitbucket ships with the pull request. reviewSummary.countsSource reports which was used. Usage: bb pr get [flags] Aliases: get, view Flags: --no-review-summary Skip the paged activity timeline walk; the summary still carries the open task tally, which costs one request ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr jira` List Jira issues associated with a pull request ```text List Jira issues associated with a pull request Usage: bb pr jira [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr list` List pull requests ```text List pull requests. Each entry carries the open task and comment counters Bitbucket reports with the pull request, so pull requests with outstanding feedback stand out. Pass --with-review-status to additionally resolve unresolved comment threads per pull request. That walks each pull request activity timeline, so it is markedly slower on a long listing. Usage: bb pr list [flags] Flags: --all Return every result rather than the first --limit --limit int Maximum number of results to return (default 25) --source-branch string Optional source branch filter --start int Start offset for Bitbucket pull request list operations --state string Pull request state filter (one of: open, closed, all) (default "open") --target-branch string Optional target branch filter --with-review-status Resolve unresolved comment threads per pull request (walks each activity timeline; slower) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr merge` Merge a pull request ```text Merge a pull request Usage: bb pr merge [flags] Flags: --version int Expected pull request version; omit to act on whatever version is current ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr merge-base` Show the common ancestor commit of a pull request's source and target branches ```text Show the common ancestor commit of a pull request's source and target branches Usage: bb pr merge-base [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr participants` Search pull request participants across a repository ```text Search pull request participants across a repository Usage: bb pr participants [flags] Flags: --search string Query filter (checks username, name, or email) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr ready` Mark a draft pull request ready for review, or turn it back into a draft ```text Mark a draft pull request ready for review. With --undo, turn an open pull request back into a draft. bb reads the pull request's current version itself. If the pull request changes between that read and the update, so that Bitbucket refuses the version as out of date, bb reads it again and retries once. A pull request already in the requested state is left as it is, and the command succeeds saying nothing changed. A merged or declined pull request is refused: only an open one can be marked ready or turned into a draft. bb pr update --draft sets the same flag alongside other fields, and takes --version for a caller who wants the change refused if the pull request has moved on since they read it. Usage: bb pr ready [flags] Examples: # Mark a draft pull request ready for review bb pr ready 42 --repo PROJ/repo # Turn it back into a draft bb pr ready 42 --repo PROJ/repo --undo Flags: --undo Turn the pull request back into a draft instead ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr rebase` Rebase a pull request ```text Rebase a pull request Usage: bb pr rebase [flags] Flags: --version int Expected pull request version ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr reopen` Reopen a pull request ```text Reopen a pull request Usage: bb pr reopen [flags] Flags: --version int Expected pull request version; omit to act on whatever version is current ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr review` Pull request review commands ```text Pull request review commands Usage: bb pr review [command] Available Commands: approve Approve a pull request complete Publish draft comments and optionally submit a status change discard Discard all draft comments and cancel review get Retrieve current draft review details reviewer Manage pull request reviewers set Set your review status on a pull request unapprove Clear your review status on a pull request Use "bb pr review [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr review approve` Approve a pull request ```text Approve a pull request. Shorthand for `bb pr review set APPROVED`. A participant holds one status, so approving replaces a request for changes rather than joining it. Usage: bb pr review approve [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr review complete` Publish draft comments and optionally submit a status change ```text Publish your draft review on a pull request: the comments you added with `bb pr comment add --pending`, together with the status and summary comment given by --status and --comment. Bitbucket completes only a review that was started, so this needs at least one draft comment. Without one it fails and changes nothing. To set a status on its own, use `bb pr review set`; to post a comment on its own, use `bb pr comment add`. Usage: bb pr review complete [flags] Examples: # Publish your draft comments bb pr review complete 42 # Publish them with a request for changes and a summary comment bb pr review complete 42 --status NEEDS_WORK --comment "Unit tests fail" Flags: --comment string Review completion comment text --status string Pull request status change (one of: APPROVED, NEEDS_WORK, UNAPPROVED) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr review discard` Discard all draft comments and cancel review ```text Discard all draft comments and cancel review Usage: bb pr review discard [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr review get` Retrieve current draft review details ```text Retrieve current draft review details Usage: bb pr review get [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr review reviewer` Manage pull request reviewers ```text Manage pull request reviewers Usage: bb pr review reviewer [command] Available Commands: add Add reviewers to a pull request remove Remove a reviewer Use "bb pr review reviewer [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr review reviewer add` Add reviewers to a pull request ```text Add reviewers to a pull request Usage: bb pr review reviewer add [flags] Examples: # Add a single reviewer bb pr review reviewer add 42 --repo PROJ/repo --user alice # Add multiple reviewers (repeatable or comma-separated) bb pr review reviewer add 42 --repo PROJ/repo --user alice --user bob bb pr review reviewer add 42 --repo PROJ/repo --users alice,bob # Add a reviewer group bb pr review reviewer add 42 --repo PROJ/repo --reviewer-group core-team bb pr review reviewer add 42 --repo PROJ/repo --user @core-team # Add default reviewers configured on repository/project bb pr review reviewer add 42 --repo PROJ/repo --default-reviewers # Add reviewers matching .bitbucket/CODEOWNERS bb pr review reviewer add 42 --repo PROJ/repo --codeowners Flags: --codeowners Assign the code owners Bitbucket reports for the change, the same ones the web interface offers; the CODEOWNERS syntax and its meaning are the server's --default-reviewers Assign default reviewers configured on repository/project for this pull request --reviewer-group strings Reviewer group name(s) to expand and add (repeatable or comma-separated; a leading @ and a reviewer-group/ prefix are both accepted; alias --reviewer-groups) --user strings Reviewer username(s) (repeatable or comma-separated, accepts @group syntax; aliases --users, --reviewers) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr review reviewer remove` Remove a reviewer ```text Remove a reviewer Usage: bb pr review reviewer remove [flags] Flags: --user string Reviewer username -y, --yes Confirm without being asked ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr review set` Set your review status on a pull request ```text Set your review status on a pull request. A participant holds exactly one status. APPROVED and NEEDS_WORK are mutually exclusive, and UNAPPROVED is neither: requesting changes replaces an approval rather than joining it, and vice versa. Setting the status you already hold is a no-op. `approve` and `unapprove` are shorthands for two of these three values. `unapprove` clears whichever status you hold, so it withdraws a request for changes as readily as an approval, which its name does not suggest. Usage: bb pr review set [flags] Examples: # Request changes bb pr review set 42 NEEDS_WORK # Approve bb pr review set 42 APPROVED # Withdraw whichever status you hold bb pr review set 42 UNAPPROVED ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr review unapprove` Clear your review status on a pull request ```text Clear your review status on a pull request. Shorthand for `bb pr review set UNAPPROVED`, and it does more than the name suggests: a participant holds one status, so this clears a request for changes as readily as an approval. There is no separate verb for withdrawing NEEDS_WORK. Usage: bb pr review unapprove [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr status` Show pull requests waiting on you ```text Show pull requests waiting on you, in three sections: the pull requests for the current branch, the ones you opened, and the ones asking for your review. The last two are cross-repository and need no repository context. The current-branch section needs a git checkout with a Bitbucket remote, and is reported as unavailable rather than as an error when there is not one. Usage: bb pr status [flags] Flags: --all Return every result rather than the first --limit --limit int Maximum number of results to return (default 25) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr unwatch` Unwatch a pull request ```text Unwatch a pull request Usage: bb pr unwatch [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr update` Update pull request metadata ```text Update a pull request's title, description, draft state or reviewers. Bitbucket refuses an update carrying a version the pull request has moved on from, rather than overwriting someone else's change. bb reads that version, so --version is only needed to assert a particular one: pass it and a pull request that has changed since is reported instead of updated. To mark a draft ready for review, or turn a pull request back into a draft, use bb pr ready. Usage: bb pr update [flags] Aliases: update, edit Examples: # Update title and description bb pr update 42 --repo PROJ/repo --title "New title" # Mark a draft PR as ready for review bb pr update 42 --repo PROJ/repo --draft=false # Refuse the update if the pull request has changed since version 1 bb pr update 42 --repo PROJ/repo --version 1 --draft Flags: --description string Updated pull request description --draft Set draft state: --draft to mark as draft, --draft=false to mark as ready for review --reviewers strings Replace the reviewers (repeatable or comma-separated, accepts @group syntax); omit to keep the current reviewers, pass "" to clear them --title string Updated pull request title --version int Expected pull request version; omit to act on whatever version is current ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb pr watch` Watch a pull request ```text Watch a pull request Usage: bb pr watch [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to inferred repository context; otherwise requires BITBUCKET_PROJECT_KEY and BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project` Project administration commands ```text Project administration commands Usage: bb project [command] Available Commands: branch-restriction Manage project branch restrictions create Create a new project default-task Manage project default checklist tasks delete Delete a project get Get project details list List projects permissions Project permissions update Update project details webhook Manage project webhooks Use "bb project [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project branch-restriction` Manage project branch restrictions ```text Manage project branch restrictions Usage: bb project branch-restriction [command] Available Commands: create Create a new project-level restriction delete Delete a project restriction get Get details of a single branch restriction list List all project branch restrictions update Update an existing restriction Use "bb project branch-restriction [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project branch-restriction create` Create a new project-level restriction ```text Create a new project-level restriction Usage: bb project branch-restriction create [flags] Flags: --access-key-id ints Allowed SSH access key IDs --group strings Allowed group names --matcher-display string Matcher display value --matcher-id string Matcher id value --matcher-type string Matcher type (one of: BRANCH, MODEL_BRANCH, MODEL_CATEGORY, PATTERN) (default "BRANCH") --type string Restriction type (one of: read-only, no-deletes, fast-forward-only, pull-request-only, no-creates) --user strings Allowed user slugs ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project branch-restriction delete` Delete a project restriction ```text Delete a project restriction Usage: bb project branch-restriction delete [flags] Flags: -y, --yes Confirm without being asked ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project branch-restriction get` Get details of a single branch restriction ```text Get details of a single branch restriction Usage: bb project branch-restriction get [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project branch-restriction list` List all project branch restrictions ```text List all project branch restrictions Usage: bb project branch-restriction list [flags] Flags: --matcher-id string Filter by matcher ID value --matcher-type string Filter by matcher type (one of: BRANCH, MODEL_BRANCH, MODEL_CATEGORY, PATTERN) --type string Filter by restriction type (one of: read-only, no-deletes, fast-forward-only, pull-request-only, no-creates) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project branch-restriction update` Update an existing restriction ```text Update an existing restriction Usage: bb project branch-restriction update [flags] Flags: --access-key-id ints Allowed SSH access key IDs --group strings Allowed group names --matcher-display string Matcher display value --matcher-id string Matcher id value --matcher-type string Matcher type (one of: BRANCH, MODEL_BRANCH, MODEL_CATEGORY, PATTERN) --type string Restriction type (one of: read-only, no-deletes, fast-forward-only, pull-request-only, no-creates) --user strings Allowed user slugs ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project create` Create a new project ```text Create a new project Usage: bb project create [flags] Flags: --description string Project description --name string Project name (required) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project default-task` Manage project default checklist tasks ```text Manage project default checklist tasks Usage: bb project default-task [command] Available Commands: add Add a default checklist task delete Delete a default checklist task list List all default checklist tasks for the project update Update a default checklist task Use "bb project default-task [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project default-task add` Add a default checklist task ```text Add a default checklist task Usage: bb project default-task add [flags] Flags: --source-ref string Source ref to match; a glob matches as a pattern, anything else as a branch (default: any ref) --target-ref string Target ref to match; a glob matches as a pattern, anything else as a branch (default: any ref) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project default-task delete` Delete a default checklist task ```text Delete a default checklist task Usage: bb project default-task delete [flags] Flags: -y, --yes Confirm without being asked ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project default-task list` List all default checklist tasks for the project ```text List all default checklist tasks for the project Usage: bb project default-task list [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project default-task update` Update a default checklist task ```text Update a default checklist task Usage: bb project default-task update [flags] Flags: --description string New task description --source-ref string New source ref to match; a glob matches as a pattern, anything else as a branch (default: any ref) --target-ref string New target ref to match; a glob matches as a pattern, anything else as a branch (default: any ref) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project delete` Delete a project ```text Delete a project Usage: bb project delete [flags] Flags: -y, --yes Confirm without being asked ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project get` Get project details ```text Get project details Usage: bb project get [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project list` List projects ```text List projects Usage: bb project list [flags] Flags: --all Return every result rather than the first --limit --limit int Maximum number of results to return (default 25) --name string Filter projects by name --start int Start offset for list operations ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project permissions` Project permissions ```text Project permissions Usage: bb project permissions [command] Available Commands: grant Grant a project permission to a user or group groups Group permissions list List users or groups with project permissions revoke Revoke a project permission from a user or group show Show the caller's effective permissions on a project users User permissions Use "bb project permissions [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project permissions grant` Grant a project permission to a user or group ```text Grant a project permission to a user, or to a group with --group. Shallow alias for bb project permissions {users,groups} grant. Usage: bb project permissions grant [flags] Flags: --group Treat the argument as a group rather than a user ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project permissions groups` Group permissions ```text Group permissions Usage: bb project permissions groups [command] Available Commands: grant Grant a project permission to a group list List groups with project permissions revoke Revoke a project permission from a group Use "bb project permissions groups [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project permissions groups grant` Grant a project permission to a group ```text Grant a project permission to a group. Also available as bb project permissions grant --group, one level shallower. Usage: bb project permissions groups grant [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project permissions groups list` List groups with project permissions ```text List groups with project permissions. Also available as bb project permissions list --group, one level shallower. Usage: bb project permissions groups list [flags] Flags: --all Return every result rather than the first --limit --limit int Maximum number of results to return (default 100) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project permissions groups revoke` Revoke a project permission from a group ```text Revoke a project permission from a group. Also available as bb project permissions revoke --group, one level shallower. Usage: bb project permissions groups revoke [flags] Flags: -y, --yes Confirm without being asked ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project permissions list` List users or groups with project permissions ```text List users with project permissions, or groups with --group. Shallow alias for bb project permissions {users,groups} list. Usage: bb project permissions list [flags] Flags: --all Return every result rather than the first --limit --group List groups instead of users --limit int Maximum number of results to return (default 100) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project permissions revoke` Revoke a project permission from a user or group ```text Revoke a project permission from a user, or from a group with --group. Shallow alias for bb project permissions {users,groups} revoke. Usage: bb project permissions revoke [flags] Flags: --group Treat the argument as a group rather than a user -y, --yes Confirm without being asked ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project permissions show` Show the caller's effective permissions on a project ```text Show the caller's effective permissions on a project Usage: bb project permissions show [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project permissions users` User permissions ```text User permissions Usage: bb project permissions users [command] Available Commands: grant Grant a project permission to a user list List users with project permissions revoke Revoke a project permission from a user Use "bb project permissions users [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project permissions users grant` Grant a project permission to a user ```text Grant a project permission to a user. Also available as bb project permissions grant, one level shallower. Usage: bb project permissions users grant [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project permissions users list` List users with project permissions ```text List users with project permissions. Also available as bb project permissions list, one level shallower. Usage: bb project permissions users list [flags] Flags: --all Return every result rather than the first --limit --limit int Maximum number of results to return (default 100) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project permissions users revoke` Revoke a project permission from a user ```text Revoke a project permission from a user. Also available as bb project permissions revoke, one level shallower. Usage: bb project permissions users revoke [flags] Flags: -y, --yes Confirm without being asked ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project update` Update project details ```text Update project details Usage: bb project update [flags] Flags: --description string Project description --name string Project name ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project webhook` Manage project webhooks ```text Manage project webhooks Usage: bb project webhook [command] Available Commands: create Create a new project-level webhook delete Delete a project webhook list List all webhooks configured for the project stats Retrieve execution statistics test Trigger a connection test ping update Update a project webhook Use "bb project webhook [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project webhook create` Create a new project-level webhook ```text Create a new project-level webhook Usage: bb project webhook create [flags] Flags: --active Whether the webhook is active (default true) --credentials-password-stdin Read the endpoint password from stdin (or set BB_WEBHOOK_PASSWORD) --credentials-username string Username Bitbucket authenticates to the endpoint with --event strings Webhook events to subscribe to (default [repo:refs_changed]) --secret-stdin Read the shared secret from stdin (or set BB_WEBHOOK_SECRET) --ssl-verification string Whether Bitbucket verifies the endpoint's TLS certificate, left as the server has it when omitted (one of: true, false) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project webhook delete` Delete a project webhook ```text Delete a project webhook Usage: bb project webhook delete [flags] Flags: -y, --yes Confirm without being asked ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project webhook list` List all webhooks configured for the project ```text List all webhooks configured for the project Usage: bb project webhook list [flags] Flags: --all Return every result rather than the first --limit --limit int Maximum number of results to return (default 25) --start int Start index for webhooks listing ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project webhook stats` Retrieve execution statistics ```text Retrieve execution statistics Usage: bb project webhook stats [flags] Flags: --summary Get statistics summary instead of detailed logs ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project webhook test` Trigger a connection test ping ```text Trigger a connection test ping Usage: bb project webhook test [flags] Flags: --reveal-secret Print the endpoint credentials Bitbucket sent instead of redacting it --url string Test this URL instead of the webhook's configured one ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb project webhook update` Update a project webhook ```text Update a project webhook Usage: bb project webhook update [flags] Flags: --active string Active status (one of: true, false) --credentials-password-stdin Read the endpoint password from stdin (or set BB_WEBHOOK_PASSWORD) --credentials-username string Username Bitbucket authenticates to the endpoint with --event strings New list of webhook events --name string New name --no-credentials Remove the endpoint credentials from the webhook --no-secret Remove the shared secret from the webhook --secret-stdin Read the shared secret from stdin (or set BB_WEBHOOK_SECRET) --ssl-verification string Whether Bitbucket verifies the endpoint's TLS certificate, left as the server has it when omitted (one of: true, false) --url string New URL ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb ref` Repository ref resolution and listing commands ```text Repository ref resolution and listing commands Usage: bb ref [command] Available Commands: list List repository refs (branches and tags) resolve Resolve a ref by name to its full ref and commit if applicable Flags: --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) Use "bb ref [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb ref list` List repository refs (branches and tags) ```text List repository refs (branches and tags) Usage: bb ref list [flags] Flags: --filter string Filter refs by name ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb ref resolve` Resolve a ref by name to its full ref and commit if applicable ```text Resolve a ref by name to its full ref and commit if applicable Usage: bb ref resolve [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo` Repository commands ```text Repository commands Usage: bb repo [command] Available Commands: admin Repository administration commands (create/fork/update/delete) archive Download repository archive browse Repository content browsing commands cat Output the raw content of a file over REST clone Clone a repository to the local filesystem comment Comment commands for commits and pull requests compare Compare commits or branches create Create a new repository default-task Manage repository default checklist tasks delete Delete a repository edit Edit a file's content over REST fork Fork a repository get Show a repository's details and its README label Manage repository labels list List repositories permissions Repository permission inspection commands settings Repository settings commands ssh-key Manage project or repository SSH access keys sync Manage repository fork synchronization unwatch Unwatch repository watch Watch repository Use "bb repo [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo admin` Repository administration commands (create/fork/update/delete) ```text Repository administration commands (create/fork/update/delete) Usage: bb repo admin [command] Available Commands: create Create a new repository delete Delete a repository fork Fork a repository update Update repository metadata Flags: --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) Use "bb repo admin [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo admin create` Create a new repository ```text Create a new repository. Alias for bb repo create. Usage: bb repo admin create [flags] Flags: --default-branch string Repository default branch --description string Repository description --forkable Repository forkable (default true) --name string Repository name --project string Project key ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo admin delete` Delete a repository ```text Delete a repository. Alias for bb repo delete. Usage: bb repo admin delete [PROJECT/slug] [flags] Flags: --yes Skip the confirmation. Only applies when the repository is named explicitly. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo admin fork` Fork a repository ```text Fork a repository. Alias for bb repo fork. Usage: bb repo admin fork [flags] Flags: --name string Name of the new fork --project string Project key of the new fork ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo admin update` Update repository metadata ```text Update repository metadata Usage: bb repo admin update [flags] Flags: --default-branch string Repository default branch --description string Repository description --name string Repository name ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo archive` Download repository archive ```text Download repository archive Usage: bb repo archive [flags] Flags: --at string The commit to stream an archive of --format string The format to stream the archive in (one of: zip, tar, tar.gz, tgz) (default "zip") -o, --output string Output filename (use '-' for stdout, defaults to .) --path string Paths to include in the streamed archive --prefix string A prefix to apply to all entries in the streamed archive --repo string Repository as PROJECT/slug ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo browse` Repository content browsing commands ```text Repository content browsing commands Usage: bb repo browse [command] Available Commands: blame Get file blame file Get structured file content history List commit history for a file raw Get raw file content tree List repository files in a directory Flags: --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) Use "bb repo browse [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo browse blame` Get file blame ```text Get file blame Usage: bb repo browse blame [flags] Flags: --at string Commit ID or ref ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo browse file` Get structured file content ```text Get structured file content Usage: bb repo browse file [flags] Flags: --at string Commit ID or ref ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo browse history` List commit history for a file ```text List commit history for a file Usage: bb repo browse history [flags] Flags: --all Return every result rather than the first --limit --limit int Maximum number of results to return (default 25) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo browse raw` Get raw file content ```text Get raw file content Usage: bb repo browse raw [flags] Flags: --at string Commit ID or ref ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo browse tree` List repository files in a directory ```text List repository files in a directory Usage: bb repo browse tree [path] [flags] Flags: --all Return every result rather than the first --limit --at string Commit ID or ref to browse --limit int Maximum number of results to return (default 1000) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo cat` Output the raw content of a file over REST ```text Output the raw content of a file over REST Usage: bb repo cat [flags] Flags: --at string Commit ID or ref to cat --repo string Repository as PROJECT/slug ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo clone` Clone a repository to the local filesystem ```text Clone a repository to the local filesystem Usage: bb repo clone [directory] [-- ...] [flags] Flags: --https Use HTTPS only and skip the SSH clone attempt --no-upstream Do not add an upstream remote when cloning a fork --ssh Use SSH only and disable HTTPS fallback -u, --upstream-remote-name string Upstream remote name when cloning a fork (default "upstream") ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo comment` Comment commands for commits and pull requests ```text Comment commands for commits and pull requests Usage: bb repo comment [command] Available Commands: create Create a comment delete Delete a comment list List comments update Update a comment Flags: --commit string Commit ID context --pr string Pull request ID context --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) Use "bb repo comment [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo comment create` Create a comment ```text Create a comment on a commit or a pull request. Pass --parent to reply to an existing comment rather than start a new thread. The id to pass is the one `bb repo comment list` reports; a reply carries reply and parentId in that listing, so a thread can be walked back to its root. Usage: bb repo comment create [flags] Flags: --line int Line within --path to anchor the comment to --line-type string Which side of the diff --line refers to (one of: ADDED, REMOVED, CONTEXT) --parent int Reply to this comment id instead of starting a new thread --path string Anchor the comment to this file, which is what makes it listable --text string Comment text ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --commit string Commit ID context --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --pr string Pull request ID context --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo comment delete` Delete a comment ```text Delete a comment Usage: bb repo comment delete [flags] Flags: --id string Comment ID --version int32 Expected comment version -y, --yes Confirm without being asked ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --commit string Commit ID context --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --pr string Pull request ID context --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo comment list` List comments ```text List comments Usage: bb repo comment list [flags] Flags: --all Return every result rather than the first --limit --limit int Maximum number of results to return (default 25) --path string File path to scope the listing to. Bitbucket requires it: a comment anchored to no file cannot be listed. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --commit string Commit ID context --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --pr string Pull request ID context --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo comment update` Update a comment ```text Update a comment Usage: bb repo comment update [flags] Flags: --id string Comment ID --text string Comment text --version int32 Expected comment version ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --commit string Commit ID context --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --pr string Pull request ID context --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo compare` Compare commits or branches ```text Compare commits or branches: what is reachable from but not from . Pass the ref you are asking about first; git log's range puts it last. bb repo compare feature/x main # what feature/x adds bb repo compare main feature/x # nothing, unless main has moved Usage: bb repo compare [flags] Flags: --diff Show the unified diff of the changes --repo string Repository as PROJECT/slug ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo create` Create a new repository ```text Create a new repository. Also available as bb repo admin create. Usage: bb repo create [flags] Flags: --default-branch string Repository default branch --description string Repository description --forkable Repository forkable (default true) --name string Repository name --project string Project key ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo default-task` Manage repository default checklist tasks ```text Manage repository default checklist tasks Usage: bb repo default-task [command] Available Commands: add Add a default checklist task delete Delete a default checklist task list List default checklist tasks update Update a default checklist task Flags: --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) Use "bb repo default-task [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo default-task add` Add a default checklist task ```text Add a default checklist task Usage: bb repo default-task add [flags] Flags: --source-ref string Source ref to match; a glob matches as a pattern, anything else as a branch (default: any ref) --target-ref string Target ref to match; a glob matches as a pattern, anything else as a branch (default: any ref) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo default-task delete` Delete a default checklist task ```text Delete a default checklist task Usage: bb repo default-task delete [flags] Flags: -y, --yes Confirm without being asked ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo default-task list` List default checklist tasks ```text List default checklist tasks Usage: bb repo default-task list [flags] ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo default-task update` Update a default checklist task ```text Update a default checklist task Usage: bb repo default-task update [flags] Flags: --description string New task description --source-ref string New source ref to match; a glob matches as a pattern, anything else as a branch (default: any ref) --target-ref string New target ref to match; a glob matches as a pattern, anything else as a branch (default: any ref) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo delete` Delete a repository ```text Delete a repository. Name the repository as a PROJECT/slug argument or with --repo. Without one it is inferred from the git remote, and --yes does not apply to an inferred target: a safety flag that works on a target you did not name is not one. At a terminal the confirmation names what will be deleted. Also available as bb repo admin delete. Usage: bb repo delete [PROJECT/slug] [flags] Flags: --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) --yes Skip the confirmation. Only applies when the repository is named explicitly. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo edit` Edit a file's content over REST ```text Edit a file's content over REST Usage: bb repo edit [flags] Flags: --branch string The branch on which the file should be modified or created --content string The full content of the file --message string Commit message --repo string Repository as PROJECT/slug --source-branch string Starting point branch --source-commit string Commit ID before editing ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo fork` Fork a repository ```text Fork a repository. Also available as bb repo admin fork. Usage: bb repo fork [flags] Flags: --name string Name of the new fork --project string Project key of the new fork --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo get` Show a repository's details and its README ```text Show a repository's description, state and clone URLs, followed by its README. The README is the file Bitbucket picks from the default branch, printed as raw markup: bb does not render it. A repository without a README says so rather than failing. --readme=false leaves the README out and skips the request for it. bb repo view is the gh spelling of the same command. To open the repository in a browser, use bb browse. Usage: bb repo get [flags] Aliases: get, view Examples: # Describe a repository and print its README bb repo get --repo PROJ/repo # Only the details bb repo get --repo PROJ/repo --readme=false Flags: --readme Include the README; --readme=false leaves it out (default true) --repo string Repository as PROJECT/slug ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo label` Manage repository labels ```text Manage repository labels Usage: bb repo label [command] Available Commands: add Add a repository label list List repository labels remove Remove a repository label Flags: --repo string Repository as PROJECT/slug (defaults to BITBUCKET_PROJECT_KEY + BITBUCKET_REPO_SLUG) Use "bb repo label [command] --help" for more information about a command. ``` ??? note "Global flags" ```text Global Flags: --ca-file string Path to PEM CA bundle for TLS trust --client-cert string Path to PEM client certificate for mTLS --client-key string Path to PEM client key for mTLS --describe Print the JSON Schema of the command's --json data payload instead of running it --dry-run Preview mutations without applying them --full-error-body Print the whole upstream response body in an error instead of a summary --insecure-skip-verify Disable TLS certificate verification (unsafe; local/dev only) --json Output as JSON --log-format string Diagnostics format: text or jsonl --log-level string Diagnostics verbosity: error, warn, info, debug --no-color Disable colored output --no-input Never prompt; fail instead when a value is missing --request-timeout string HTTP request timeout (Go duration, e.g. 20s) --retry-backoff string Base retry backoff duration (e.g. 250ms) --retry-count int HTTP retry attempts for transient errors (default -1) ``` ## `bb repo label add` Add a repository label ```text Add a repository label Usage: bb repo label add