All Commands¶
238 commands, on a page per top-level command. Each also takes the global flags.
bb admin- Check that the configured Bitbucket answers and accepts your credentials (1 command)
bb ai- Run bb's MCP server, and install its agent skill (5 commands)
bb api- Send a raw HTTP request to the Bitbucket REST API
bb auth- Log in, check the setup, and manage tokens, keys and git credentials (22 commands)
bb branch- Create, list and delete branches, and set the default branch and restrictions (12 commands)
bb browse- Open repository pages in a web browser
bb build- Report and read build statuses, and require builds before a merge (10 commands)
bb clone- Clone a repository to the local filesystem
bb commit- List, show and compare commits, and find a commit's pull requests (4 commands)
bb completion- Set shell completion up, or print the script for a shell (2 commands)
bb deployment- Record, read and delete the deployments of a commit (3 commands)
bb diff- Print the diff of a pull request, a commit or two refs (3 commands)
bb doctor- Check the configuration bb would load
bb dry-run- What --dry-run answers, and how far to trust it
bb insights- Publish and read Code Insights reports and annotations (8 commands)
bb pr- Create, review, merge and inspect pull requests (42 commands)
bb project- Create and change projects, and the settings their repositories inherit (30 commands)
bb ref- List a repository's branches and tags, and resolve a ref to its commit (2 commands)
bb repo- Create, clone, browse and configure repositories (63 commands)
bb reviewer- Choose who is added to a pull request as a reviewer by default (4 commands)
bb reviewer-group- Create, list and change reviewer groups and their members (5 commands)
bb search- Search for repositories, commits, and pull requests (3 commands)
bb ssh-key- Add, list and remove your SSH keys (3 commands)
bb tag- Create, list, view and delete tags (4 commands)
bb update- Check for and install the latest bb release
bb webhook- Create, list, test and change a repository's webhooks (7 commands)
Every command¶
bb admin¶
admin health- Probe the configured Bitbucket for reachability and authentication
bb ai¶
ai mcp serve- Start the MCP server (stdio transport)
ai mcp tools- List MCP tools with what they change and whether they ask
ai skill install- Write an agent skill to the agent skills directories
ai skill remove- Remove an installed agent skill file
ai skill show- Print an agent skill to stdout
bb auth¶
auth alias add- Add aliases to a stored server context
auth alias discover- Discover aliases from the first accessible repository clone links
auth alias list- List aliases for a stored server context
auth alias remove- Remove an alias from a stored server context
auth git-credential- Git credential helper (invoked by git, not run directly)
auth gpg-key add- Add a personal GPG key
auth gpg-key clear- Clear all personal GPG keys
auth gpg-key list- List personal GPG keys
auth gpg-key remove- Remove a personal GPG key
auth identity- Show authenticated user identity
auth login- Store credentials for a Bitbucket host
auth logout- Remove stored credentials for a Bitbucket host
auth server list- List stored server contexts
auth server use- Set the active default server context
auth setup-git- Configure git to authenticate to Bitbucket through bb
auth status- Show the configured target and verify it works
auth token create- Create an HTTP access token
auth token get- Get an HTTP access token by ID
auth token list- List HTTP access tokens
auth token revoke- Revoke an HTTP access token by ID
auth token update- Update an HTTP access token name or permissions
auth token-url- Show personal access token creation URL
bb branch¶
branch create- Create repository branch
branch default get- Get repository default branch
branch default set- Set repository default branch
branch delete- Delete repository branch
branch list- List repository branches
branch model inspect- Show the branch a commit belongs to
branch model update- Update repository default branch used by branch model settings
branch restriction create- Create branch restriction
branch restriction delete- Delete branch restriction
branch restriction get- Get branch restriction by id
branch restriction list- List branch restrictions
branch restriction update- Update branch restriction
bb build¶
build delete- Delete repository-scoped build status by key
build get- Get repository-scoped build status by key
build required create- Create required build merge check
build required delete- Delete required build merge check
build required list- List required build merge checks
build required update- Update required build merge check
build set- Set repository-scoped build status for a commit
build status get- Get build statuses for a commit
build status set- Set build status for a commit
build status stats- Get build status summary counts for one or more commits
bb commit¶
commit compare- Compare two commits or refs
commit get- Get a specific commit
commit list- List repository commits
commit prs- List pull requests containing a commit
bb completion¶
completion install- Set completion up so every new shell completes bb
completion remove- Take out what bb completion install set up
bb deployment¶
deployment create- Create or update a repository-scoped deployment for a commit
deployment delete- Delete repository-scoped deployment for a commit
deployment get- Get repository-scoped deployment details for a commit
bb diff¶
diff commit- Diff a commit against its parent
diff pr- Diff a pull request
diff refs- Diff two refs or commits
bb insights¶
insights annotation add- Add annotations to a Code Insights report
insights annotation delete- Delete annotation(s) by external id for a report
insights annotation list- List annotations for a Code Insights report or commit
insights annotation set- Create or replace a Code Insights report annotation
insights report delete- Delete a Code Insights report
insights report get- Get a Code Insights report
insights report list- List Code Insights reports for a commit
insights report set- Create or update a Code Insights report
bb pr¶
pr activity list- List raw pull request activity items
pr auto-merge disable- Disable auto-merge on a pull request
pr auto-merge enable- Enable auto-merge on a pull request
pr auto-merge get- Get auto-merge configuration for a pull request
pr build status- Show build statuses for a pull request's source commit (also available as bb pr checks)
pr checkout- Check out a pull request branch locally
pr checks- Show build statuses for a pull request's source commit (alias for bb pr build status)
pr comment add- Add a comment to a pull request
pr comment apply-suggestion- Apply a suggested change from a comment
pr comment delete- Delete a pull request comment or task
pr comment get- Get a pull request comment
pr comment list- List comment threads for a pull request, unresolved first
pr comment react- Add or remove a reaction on a pull request comment
pr comment reopen- Reopen a resolved pull request comment
pr comment resolve- Resolve a pull request comment, closing it as a task
pr commits- List the commits in a pull request
pr create- Create a pull request
pr decline- Decline a pull request
pr default-reviewers- List default reviewers and matching conditions for repository
pr diff- Diff a pull request (alias for bb diff pr)
pr files- List the files changed in a pull request
pr get- Get pull request details, including outstanding review feedback
pr jira- List Jira issues associated with a pull request
pr list- List pull requests
pr merge- Merge a pull request
pr merge-base- Show the common ancestor commit of a pull request's source and target branches
pr participants- Search pull request participants across a repository
pr ready- Mark a draft pull request ready for review, or turn it back into a draft
pr rebase- Rebase a pull request
pr reopen- Reopen a pull request
pr review approve- Approve a pull request
pr review complete- Publish draft comments and optionally submit a status change
pr review discard- Discard all draft comments and cancel review
pr review get- Retrieve current draft review details
pr review reviewer add- Add reviewers to a pull request
pr review reviewer remove- Remove a reviewer
pr review set- Set your review status on a pull request
pr review unapprove- Clear your review status on a pull request
pr status- Show pull requests waiting on you
pr unwatch- Unwatch a pull request
pr update- Update pull request metadata
pr watch- Watch a pull request
bb project¶
project branch-restriction create- Create a new project-level restriction
project branch-restriction delete- Delete a project restriction
project branch-restriction get- Get details of a single branch restriction
project branch-restriction list- List all project branch restrictions
project branch-restriction update- Update an existing restriction
project create- Create a new project
project default-task add- Add a default checklist task
project default-task delete- Delete a default checklist task
project default-task list- List all default checklist tasks for the project
project default-task update- Update a default checklist task
project delete- Delete a project
project get- Get project details
project list- List projects
project permissions grant- Grant a project permission to a user or group
project permissions groups grant- Grant a project permission to a group
project permissions groups list- List groups with project permissions
project permissions groups revoke- Revoke a project permission from a group
project permissions list- List users or groups with project permissions
project permissions revoke- Revoke a project permission from a user or group
project permissions show- Show the caller's effective permissions on a project
project permissions users grant- Grant a project permission to a user
project permissions users list- List users with project permissions
project permissions users revoke- Revoke a project permission from a user
project update- Update project details
project webhook create- Create a new project-level webhook
project webhook delete- Delete a project webhook
project webhook list- List all webhooks configured for the project
project webhook stats- Retrieve execution statistics
project webhook test- Trigger a connection test ping
project webhook update- Update a project webhook
bb ref¶
ref list- List repository refs (branches and tags)
ref resolve- Resolve a ref by name to its full ref and commit if applicable
bb repo¶
repo admin create- Create a new repository
repo admin delete- Delete a repository
repo admin fork- Fork a repository
repo admin update- Update repository metadata
repo archive- Download repository archive
repo browse blame- Get file blame
repo browse file- Get structured file content
repo browse history- List commit history for a file
repo browse raw- Get raw file content
repo browse tree- List repository files in a directory
repo cat- Output the raw content of a file over REST
repo clone- Clone a repository to the local filesystem
repo comment create- Create a comment
repo comment delete- Delete a comment
repo comment list- List comments
repo comment update- Update a comment
repo compare- Compare commits or branches
repo create- Create a new repository
repo default-task add- Add a default checklist task
repo default-task delete- Delete a default checklist task
repo default-task list- List default checklist tasks
repo default-task update- Update a default checklist task
repo delete- Delete a repository
repo edit- Edit a file's content over REST
repo fork- Fork a repository
repo get- Show a repository's details and its README
repo label add- Add a repository label
repo label list- List repository labels
repo label remove- Remove a repository label
repo list- List repositories
repo permissions grant- Grant a repository permission to a user or group
repo permissions list- List users or groups with repository permissions
repo permissions revoke- Revoke a repository permission from a user or group
repo permissions show- Show the caller's effective permissions on a repository
repo settings auto-decline delete- Delete repository auto-decline settings
repo settings auto-decline get- Get repository auto-decline settings
repo settings auto-decline set- Set repository auto-decline settings
repo settings auto-merge delete- Delete repository auto-merge settings
repo settings auto-merge get- Get repository auto-merge settings
repo settings auto-merge set- Set repository auto-merge settings
repo settings pull-requests get- Get repository pull-request settings
repo settings pull-requests merge-checks list- List configured merge checks
repo settings pull-requests set-strategy- Set default merge strategy
repo settings pull-requests update- Update repository pull-request settings
repo settings pull-requests update-approvers- Update required approvers count
repo settings security permissions groups grant- Grant a repository permission to a group
repo settings security permissions groups list- List groups with repository permissions
repo settings security permissions groups revoke- Revoke a repository permission from a group
repo settings security permissions users grant- Grant a repository permission to a user
repo settings security permissions users list- List users with repository permissions
repo settings security permissions users revoke- Revoke a repository permission from a user
repo settings workflow webhooks create- Create a repository webhook
repo settings workflow webhooks delete- Delete a repository webhook
repo settings workflow webhooks list- List repository webhooks
repo ssh-key add- Add a project or repository SSH access key
repo ssh-key list- List project or repository SSH access keys
repo ssh-key remove- Remove a project or repository SSH access key by ID
repo sync- Bring a fork up to date with its origin, and turn automatic syncing on or off
repo sync disable- Disable automatic background synchronization
repo sync enable- Enable automatic background synchronization
repo sync status- Query synchronization status, divergence, and settings
repo unwatch- Unwatch repository
repo watch- Watch repository
bb reviewer¶
reviewer condition create- Create a default reviewer condition
reviewer condition delete- Delete a default reviewer condition
reviewer condition list- List default reviewer conditions
reviewer condition update- Update a default reviewer condition
bb reviewer-group¶
reviewer-group create- Create a reviewer group
reviewer-group delete- Delete a reviewer group
reviewer-group list- List reviewer groups
reviewer-group update- Update a reviewer group
reviewer-group users- List the members of a repository reviewer group who can see the repository
bb search¶
search commits- Search for commits within a repository
search prs- Search for pull requests globally or within a repository
search repos- Search for repositories
bb ssh-key¶
ssh-key add- Add a personal SSH key
ssh-key list- List personal SSH keys
ssh-key remove- Remove a personal SSH key by ID
bb tag¶
tag create- Create repository tag
tag delete- Delete repository tag
tag list- List repository tags
tag view- View repository tag
bb webhook¶
webhook create- Create a repository webhook
webhook delete- Delete a repository webhook
webhook get- Get a repository webhook by ID
webhook list- List repository webhooks
webhook stats- Get repository webhook statistics
webhook test- Test connection to repository webhook URL by sending a ping event
webhook update- Update a repository webhook
bb¶
Bitbucket Data Center CLI (live-behavior first)
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.