bkt

Bitbucket CLI (bkt)

Use bkt for Bitbucket Cloud and Data Center operations. Prefer structured --json, --yaml, --jq, or --template output for automation.

Start with the requested operation

Run bkt --version only when installation or compatibility is uncertain. Run bkt auth status when the command needs authentication or the active platform and context are unknown. Do not make setup a prerequisite for an already configured read-only request.

Cloud and Data Center have different feature sets. Determine the platform from the active context or ask when it cannot be inferred. Do not suggest a Cloud-only command for Data Center, or the reverse.

Read setup and common workflows when installing, authenticating, creating a context, or learning the main command patterns. For config-free CI or containers, read headless authentication.

Route to the command reference

Read only the reference for the requested command group:

• pull requests, repositories,

branches, commits, or statuses

• Cloud issues, pipelines, or

variables

• Data Center administration,

projects, or permissions

• authentication, contexts,

webhooks, extensions, MCP, skills, or raw API

Mutation and credential boundaries

• Listing, viewing, status, and checks are read-only. Create, edit, approve,

merge, delete, rerun, or permission changes modify Bitbucket; perform them only when the user requested that change.

• Never place tokens, OAuth secrets, or passwords in commands that could enter

logs or committed files. Use the CLI's supported credential flow or environment variables described in the auth references.

• Official release binaries embed the Cloud browser-OAuth consumer credentials.

Do not remove that behavior as generic hardening. Source and Nix builds may require BKT_OAUTH_CLIENT_ID and BKT_OAUTH_CLIENT_SECRET.

• Before a merge or other consequential write, inspect the exact target,

repository, and current checks. Report the resulting URL or identifier.

References

<!-- auto-generated by cmd/docgen — do not edit below this line -->

• admin — Administrative operations for Bitbucket (DC)
• auth — Manage Bitbucket authentication credentials
• branch — Inspect and manage branches
• commit — Work with commits
• context — Manage Bitbucket CLI contexts
• extension — Manage bkt CLI extensions
• issue — Work with Bitbucket Cloud issues (Cloud)
• mcp — Model Context Protocol server for agents
• perms — Manage Bitbucket permissions (DC)
• pipeline — Run and inspect Bitbucket Cloud pipelines (Cloud)
• pr — Manage pull requests
• project — Work with Bitbucket projects (DC)
• repo — Work with Bitbucket repositories
• skill — Install and manage agent skills
• status — Inspect commit and pull request statuses
• variable — Manage pipeline variables (Cloud)
• webhook — Manage Bitbucket webhooks
• other — api

<!-- end auto-generated -->