Atlassian Bitbucket Cloud by @altf1be#

Full CRUD on repos, PRs, pipelines, issues, snippets, workspaces, branches, deployments, and more via Bitbucket REST API 2.0.

Setup#

1. Create an API Token at https://id.atlassian.com/manage-profile/security/api-tokens (select the scopes you need).
2. Set environment variables (or create .env in {baseDir}):

text

# Required
BITBUCKET_EMAIL=you@example.com
BITBUCKET_API_TOKEN=your-api-token

# Optional
BITBUCKET_WORKSPACE=your-default-workspace
BITBUCKET_MAX_RESULTS=50

# Legacy (supported until June 9, 2026)
# BITBUCKET_USERNAME=your-username
# BITBUCKET_APP_PASSWORD=your-app-password

1. Install dependencies: cd {baseDir} && npm install

Common Options#

Most commands accept these shared flags:

FlagDescription-w, --workspace <slug>Workspace slug (or set BITBUCKET_WORKSPACE)-r, --repo <slug>Repository slug--pagelen <n>Results per page--page <n>Page number--allFetch all pages-q, --q <filter>Filter query (CQL-style)--sort <field>Sort field--confirmRequired for all delete operations--data <json>Raw JSON body for complex payloads

Commands#

1. Repositories (26 commands)#

CRUD on repositories, forks, watchers, webhooks, override settings, and permissions.

CommandDescriptionrepo-list-publicList all public repositoriesrepo-listList repositories in a workspacerepo-getGet repository detailsrepo-createCreate a new repositoryrepo-updateUpdate repository settingsrepo-deleteDelete a repositoryrepo-forksList forks of a repositoryrepo-fork-createFork a repositoryrepo-watchersList repository watchershook-listList repository webhookshook-getGet a webhook by UIDhook-createCreate a repository webhookhook-updateUpdate a webhookhook-deleteDelete a webhookrepo-override-settings-getGet repository override settingsrepo-override-settings-updateUpdate repository override settingsrepo-group-permission-listList group permissionsrepo-group-permission-getGet a group's permissionrepo-group-permission-updateUpdate a group's permissionrepo-group-permission-deleteRemove a group's permissionrepo-user-permission-listList user permissionsrepo-user-permission-getGet a user's permissionrepo-user-permission-updateUpdate a user's permissionrepo-user-permission-deleteRemove a user's permissionuser-repo-permissionsList current user's repository permissionsuser-ws-repo-permissionsList current user's repository permissions in a workspacebash

# List repos in a workspace
bitbucket repo-list -w myworkspace

# Get repo details
bitbucket repo-get -w myworkspace -r my-repo

# Create a new private repo
bitbucket repo-create -w myworkspace -r new-repo --is-private true --scm git

# Fork a repo
bitbucket repo-fork-create -w myworkspace -r upstream-repo --data '{"name":"my-fork"}'

# Create a webhook
bitbucket hook-create -w myworkspace -r my-repo --url https://example.com/hook --events repo:push

# Delete a repo (requires --confirm)
bitbucket repo-delete -w myworkspace -r old-repo --confirm

2. Pull Requests (36 commands)#

Full lifecycle management of pull requests: create, review, approve, merge, comment, tasks, and default reviewers.

CommandDescriptionpr-listList pull requestspr-createCreate a pull requestpr-getGet a pull request by IDpr-updateUpdate a pull requestpr-activityGet PR activity logpr-approveApprove a pull requestpr-unapproveRemove approval from a PRpr-commentsList PR commentspr-comment-createAdd a comment to a PRpr-comment-getGet a specific PR commentpr-comment-updateUpdate a PR commentpr-comment-deleteDelete a PR commentpr-comment-resolveResolve a PR comment threadpr-comment-reopenReopen a resolved comment threadpr-commitsList commits in a PRpr-declineDecline a pull requestpr-diffGet the diff of a PRpr-diffstatGet the diffstat of a PRpr-mergeMerge a pull requestpr-merge-task-statusCheck merge task statuspr-patchGet the patch of a PRpr-request-changesRequest changes on a PRpr-unrequest-changesRemove change request from a PRpr-statusesList commit statuses on a PRpr-tasksList tasks on a PRpr-task-createCreate a task on a PRpr-task-getGet a specific PR taskpr-task-updateUpdate a PR taskpr-task-deleteDelete a PR taskdefault-reviewer-listList default reviewersdefault-reviewer-getGet a default reviewerdefault-reviewer-addAdd a default reviewerdefault-reviewer-deleteRemove a default reviewereffective-default-reviewersList effective default reviewerspr-for-commitFind PRs containing a commitpr-activity-allGet activity across all PRs in a repobash

# List open PRs
bitbucket pr-list -w myworkspace -r my-repo -q 'state="OPEN"'

# Create a PR
bitbucket pr-create -w myworkspace -r my-repo --title "Add feature" \
  --source feature-branch --destination main

# Approve a PR
bitbucket pr-approve -w myworkspace -r my-repo --pr-id 42

# Merge a PR
bitbucket pr-merge -w myworkspace -r my-repo --pr-id 42 --merge-strategy squash

# Add a comment
bitbucket pr-comment-create -w myworkspace -r my-repo --pr-id 42 \
  --body "Looks good to me!"

# Create a task on a PR
bitbucket pr-task-create -w myworkspace -r my-repo --pr-id 42 \
  --data '{"content":{"raw":"Fix the typo on line 10"}}'

# Find PRs for a commit
bitbucket pr-for-commit -w myworkspace -r my-repo --commit abc123

3. Commits (16 commands)#

Read commit details, approve/unapprove commits, manage commit comments, list diffs and patches.

CommandDescriptioncommit-getGet a specific commitcommit-approveApprove a commitcommit-unapproveRemove commit approvalcommit-commentsList comments on a commitcommit-comment-createAdd a comment to a commitcommit-comment-getGet a specific commit commentcommit-comment-updateUpdate a commit commentcommit-comment-deleteDelete a commit commentcommit-listList commits (GET)commit-list-postList commits (POST, with body filters)commit-list-revisionList commits from a revision (GET)commit-list-revision-postList commits from a revision (POST)diffGet diff between two refsdiffstatGet diffstat between two refsmerge-baseGet merge base of two refspatchGet patch for a revisionbash

# Get commit details
bitbucket commit-get -w myworkspace -r my-repo --commit abc123def

# List recent commits
bitbucket commit-list -w myworkspace -r my-repo --pagelen 10

# Get diff between two refs
bitbucket diff -w myworkspace -r my-repo --spec "main..feature-branch"

# Approve a commit
bitbucket commit-approve -w myworkspace -r my-repo --commit abc123def

# Comment on a commit
bitbucket commit-comment-create -w myworkspace -r my-repo --commit abc123def \
  --body "This needs a test."

4. Branches & Tags (9 commands)#

List, create, get, and delete branches and tags.

CommandDescriptionref-listList all refs (branches + tags)branch-listList branchesbranch-createCreate a branchbranch-getGet branch detailsbranch-deleteDelete a branchtag-listList tagstag-createCreate an annotated tagtag-getGet tag detailstag-deleteDelete a tagbash

# List branches
bitbucket branch-list -w myworkspace -r my-repo

# Create a branch
bitbucket branch-create -w myworkspace -r my-repo --name feature/new \
  --target main

# Create a tag
bitbucket tag-create -w myworkspace -r my-repo --name v1.0.0 --target main

# Delete a branch (requires --confirm)
bitbucket branch-delete -w myworkspace -r my-repo --name old-branch --confirm

5. Branch Restrictions (5 commands)#

Manage branch permission restrictions (push, merge, delete controls).

CommandDescriptionrestriction-listList branch restrictionsrestriction-getGet a restriction by IDrestriction-createCreate a branch restrictionrestriction-updateUpdate a branch restrictionrestriction-deleteDelete a branch restrictionbash

# List restrictions
bitbucket restriction-list -w myworkspace -r my-repo

# Prevent force-push to main
bitbucket restriction-create -w myworkspace -r my-repo \
  --data '{"kind":"force","pattern":"main"}'

# Delete a restriction (requires --confirm)
bitbucket restriction-delete -w myworkspace -r my-repo --id 123 --confirm

6. Branching Model (7 commands)#

Get and configure the branching model (Git Flow style) at the repo and project level.

CommandDescriptionbranching-model-getGet repo branching modelbranching-model-settings-getGet repo branching model settingsbranching-model-settings-updateUpdate repo branching model settingsbranching-model-effectiveGet effective branching model (inherited + overrides)project-branching-model-getGet project branching modelproject-branching-model-settings-getGet project branching model settingsproject-branching-model-settings-updateUpdate project branching model settingsbash

# Get effective branching model
bitbucket branching-model-effective -w myworkspace -r my-repo

# Update branching model settings
bitbucket branching-model-settings-update -w myworkspace -r my-repo \
  --data '{"development":{"name":"develop"},"production":{"name":"main"}}'

7. Pipelines (68 commands)#

Full pipeline lifecycle: run, stop, inspect steps/logs, manage variables, schedules, SSH keys, known hosts, caches, runners, OIDC, and workspace/team/user-level pipeline variables.

CommandDescriptionpipeline-listList pipelinespipeline-getGet pipeline detailspipeline-createTrigger a new pipelinepipeline-stopStop a running pipelinepipeline-stepsList steps in a pipelinepipeline-step-getGet a pipeline steppipeline-step-logGet step log outputpipeline-step-log-containerGet step container logpipeline-test-reportsGet test reports for a steppipeline-test-casesGet test cases for a steppipeline-test-case-reasonsGet test case failure reasonspipeline-config-getGet pipeline configurationpipeline-config-updateUpdate pipeline configurationpipeline-build-number-updateUpdate the next build numberpipeline-var-listList repo pipeline variablespipeline-var-getGet a pipeline variablepipeline-var-createCreate a pipeline variablepipeline-var-updateUpdate a pipeline variablepipeline-var-deleteDelete a pipeline variablepipeline-schedule-listList pipeline schedulespipeline-schedule-getGet a schedulepipeline-schedule-createCreate a pipeline schedulepipeline-schedule-updateUpdate a pipeline schedulepipeline-schedule-deleteDelete a pipeline schedulepipeline-schedule-executionsList schedule executionspipeline-ssh-keypair-getGet SSH key pairpipeline-ssh-keypair-updateUpdate SSH key pairpipeline-ssh-keypair-deleteDelete SSH key pairpipeline-known-host-listList known hostspipeline-known-host-getGet a known hostpipeline-known-host-createAdd a known hostpipeline-known-host-updateUpdate a known hostpipeline-known-host-deleteDelete a known hostpipeline-cache-listList pipeline cachespipeline-cache-deleteDelete all cachespipeline-cache-delete-by-nameDelete a cache by namepipeline-cache-content-uriGet cache content URIpipeline-runner-listList repo pipeline runnerspipeline-runner-getGet a pipeline runnerpipeline-runner-createCreate a pipeline runnerpipeline-runner-updateUpdate a pipeline runnerpipeline-runner-deleteDelete a pipeline runnerenv-var-listList deployment environment variablesenv-var-createCreate a deployment env variableenv-var-updateUpdate a deployment env variableenv-var-deleteDelete a deployment env variableteam-pipeline-var-listList team pipeline variablesteam-pipeline-var-getGet a team pipeline variableteam-pipeline-var-createCreate a team pipeline variableteam-pipeline-var-updateUpdate a team pipeline variableteam-pipeline-var-deleteDelete a team pipeline variableuser-pipeline-var-listList user pipeline variablesuser-pipeline-var-getGet a user pipeline variableuser-pipeline-var-createCreate a user pipeline variableuser-pipeline-var-updateUpdate a user pipeline variableuser-pipeline-var-deleteDelete a user pipeline variablews-oidc-configGet workspace OIDC configurationws-oidc-keysGet workspace OIDC keysws-runner-listList workspace runnersws-runner-getGet a workspace runnerws-runner-createCreate a workspace runnerws-runner-updateUpdate a workspace runnerws-runner-deleteDelete a workspace runnerws-pipeline-var-listList workspace pipeline variablesws-pipeline-var-getGet a workspace pipeline variablews-pipeline-var-createCreate a workspace pipeline variablews-pipeline-var-updateUpdate a workspace pipeline variablews-pipeline-var-deleteDelete a workspace pipeline variablebash

# Trigger a pipeline on main
bitbucket pipeline-create -w myworkspace -r my-repo \
  --data '{"target":{"ref_type":"branch","type":"pipeline_ref_target","ref_name":"main"}}'

# List recent pipelines
bitbucket pipeline-list -w myworkspace -r my-repo --pagelen 5

# Get step logs
bitbucket pipeline-step-log -w myworkspace -r my-repo \
  --pipeline-uuid {uuid} --step-uuid {uuid}

# Stop a running pipeline
bitbucket pipeline-stop -w myworkspace -r my-repo --pipeline-uuid {uuid}

# Create a repo pipeline variable (secured)
bitbucket pipeline-var-create -w myworkspace -r my-repo \
  --key API_KEY --value secret123 --secured true

# Create a workspace-level variable
bitbucket ws-pipeline-var-create -w myworkspace \
  --key DEPLOY_TOKEN --value tok_abc --secured true

# Schedule a pipeline
bitbucket pipeline-schedule-create -w myworkspace -r my-repo \
  --data '{"cron_pattern":"0 0 * * *","target":{"ref_type":"branch","ref_name":"main"}}'

8. Deployments (16 commands)#

Manage deploy keys and deployment environments.

CommandDescriptiondeploy-key-listList deploy keysdeploy-key-getGet a deploy keydeploy-key-createAdd a deploy keydeploy-key-updateUpdate a deploy keydeploy-key-deleteDelete a deploy keydeployment-listList deploymentsdeployment-getGet a deploymentenvironment-listList deployment environmentsenvironment-getGet an environmentenvironment-createCreate a deployment environmentenvironment-updateUpdate a deployment environmentenvironment-deleteDelete a deployment environmentproject-deploy-key-listList project deploy keysproject-deploy-key-getGet a project deploy keyproject-deploy-key-createAdd a project deploy keyproject-deploy-key-deleteDelete a project deploy keybash

# List deployment environments
bitbucket environment-list -w myworkspace -r my-repo

# Create a staging environment
bitbucket environment-create -w myworkspace -r my-repo \
  --data '{"name":"Staging","environment_type":{"name":"Staging"}}'

# Add a deploy key
bitbucket deploy-key-create -w myworkspace -r my-repo \
  --key "ssh-rsa AAAA..." --label "CI deploy key"

# Delete an environment (requires --confirm)
bitbucket environment-delete -w myworkspace -r my-repo \
  --environment-uuid {uuid} --confirm

9. Commit Statuses (4 commands)#

Create and manage build statuses on commits.

CommandDescriptionstatus-listList commit statusesstatus-createCreate a commit statusstatus-getGet a commit statusstatus-updateUpdate a commit statusbash

# Report a build status
bitbucket status-create -w myworkspace -r my-repo --commit abc123 \
  --state SUCCESSFUL --key build-42 --url https://ci.example.com/42

# List statuses on a commit
bitbucket status-list -w myworkspace -r my-repo --commit abc123

10. Issue Tracker (33 commands)#

Full issue management: CRUD, comments, attachments, changes, voting, watching, import/export, components, milestones, and versions.

CommandDescriptionissue-listList issuesissue-getGet an issueissue-createCreate an issueissue-updateUpdate an issueissue-deleteDelete an issueissue-comment-listList issue commentsissue-comment-getGet an issue commentissue-comment-createAdd a comment to an issueissue-comment-updateUpdate an issue commentissue-comment-deleteDelete an issue commentissue-attachment-listList issue attachmentsissue-attachment-getGet an issue attachmentissue-attachment-uploadUpload an attachmentissue-attachment-deleteDelete an attachmentissue-change-listList issue changesissue-change-getGet an issue changeissue-change-createCreate an issue changeissue-vote-checkCheck if you voted on an issueissue-voteVote on an issueissue-unvoteRemove your voteissue-watch-checkCheck if you are watching an issueissue-watchWatch an issueissue-unwatchStop watching an issueissue-exportStart an issue exportissue-export-statusCheck export statusissue-importStart an issue importissue-import-statusCheck import statuscomponent-listList componentscomponent-getGet a componentmilestone-listList milestonesmilestone-getGet a milestoneversion-listList versionsversion-getGet a versionbash

# List open bugs
bitbucket issue-list -w myworkspace -r my-repo -q 'kind="bug" AND state="open"'

# Create an issue
bitbucket issue-create -w myworkspace -r my-repo \
  --title "Login broken" --kind bug --priority critical

# Comment on an issue
bitbucket issue-comment-create -w myworkspace -r my-repo --issue-id 7 \
  --body "Reproduced on Chrome 120."

# Upload an attachment
bitbucket issue-attachment-upload -w myworkspace -r my-repo --issue-id 7 \
  --file ./screenshot.png

# Export all issues
bitbucket issue-export -w myworkspace -r my-repo

# List milestones
bitbucket milestone-list -w myworkspace -r my-repo

11. Snippets (25 commands)#

Create and manage code snippets, their revisions, files, diffs, comments, commits, and watchers.

CommandDescriptionsnippet-listList your snippetssnippet-createCreate a snippetsnippet-ws-listList workspace snippetssnippet-ws-createCreate a workspace snippetsnippet-getGet a snippetsnippet-updateUpdate a snippetsnippet-deleteDelete a snippetsnippet-revision-getGet a snippet revisionsnippet-revision-updateUpdate a snippet revisionsnippet-revision-deleteDelete a snippet revisionsnippet-fileGet a file from a snippetsnippet-file-revisionGet a file at a specific revisionsnippet-diffGet diff between snippet revisionssnippet-patchGet patch for a snippet revisionsnippet-comment-listList snippet commentssnippet-comment-getGet a snippet commentsnippet-comment-createAdd a comment to a snippetsnippet-comment-updateUpdate a snippet commentsnippet-comment-deleteDelete a snippet commentsnippet-commit-listList snippet commitssnippet-commit-getGet a snippet commitsnippet-watch-checkCheck if watching a snippetsnippet-watchWatch a snippetsnippet-unwatchUnwatch a snippetsnippet-watchersList snippet watchersbash

# List your snippets
bitbucket snippet-list

# Create a snippet
bitbucket snippet-create --title "Bash helper" --is-private true \
  --file ./helper.sh

# List workspace snippets
bitbucket snippet-ws-list -w myworkspace

# Get a specific file from a snippet
bitbucket snippet-file -w myworkspace --snippet-id abc123 --filename helper.sh

# Delete a snippet (requires --confirm)
bitbucket snippet-delete -w myworkspace --snippet-id abc123 --confirm

12. Workspaces (17 commands)#

List workspaces, manage hooks, members, permissions, and list user PRs.

CommandDescriptionworkspace-listList workspaces you belong toworkspace-list-for-userList workspaces for a userworkspace-permissions-for-userGet workspace permissions for a userworkspace-user-permissionGet a specific user's workspace permissionworkspace-getGet workspace detailsworkspace-hook-listList workspace webhooksworkspace-hook-getGet a workspace webhookworkspace-hook-createCreate a workspace webhookworkspace-hook-updateUpdate a workspace webhookworkspace-hook-deleteDelete a workspace webhookworkspace-member-listList workspace membersworkspace-member-getGet a workspace memberworkspace-permission-listList workspace permissionsworkspace-repo-permissionsList repo-level permissions in workspaceworkspace-repo-permission-getGet repo-level permissionworkspace-project-listList projects in a workspaceworkspace-user-prsList PRs authored by the current user in a workspacebash

# List workspaces
bitbucket workspace-list

# Get workspace details
bitbucket workspace-get -w myworkspace

# List workspace members
bitbucket workspace-member-list -w myworkspace

# List my open PRs across the workspace
bitbucket workspace-user-prs -w myworkspace -q 'state="OPEN"'

# Create a workspace webhook
bitbucket workspace-hook-create -w myworkspace \
  --url https://example.com/hook --events repo:push,pullrequest:created

13. Projects (16 commands)#

CRUD on projects, default reviewers, and group/user permissions at the project level.

CommandDescriptionproject-createCreate a projectproject-getGet a projectproject-updateUpdate a projectproject-deleteDelete a projectproject-default-reviewer-listList project default reviewersproject-default-reviewer-getGet a project default reviewerproject-default-reviewer-addAdd a project default reviewerproject-default-reviewer-deleteRemove a project default reviewerproject-group-permission-listList project group permissionsproject-group-permission-getGet a group's project permissionproject-group-permission-updateUpdate a group's project permissionproject-group-permission-deleteRemove a group's project permissionproject-user-permission-listList project user permissionsproject-user-permission-getGet a user's project permissionproject-user-permission-updateUpdate a user's project permissionproject-user-permission-deleteRemove a user's project permissionbash

# Create a project
bitbucket project-create -w myworkspace --key PROJ --name "My Project"

# List project default reviewers
bitbucket project-default-reviewer-list -w myworkspace --project-key PROJ

# Add a default reviewer to a project
bitbucket project-default-reviewer-add -w myworkspace --project-key PROJ \
  --user-uuid {uuid}

# Delete a project (requires --confirm)
bitbucket project-delete -w myworkspace --project-key PROJ --confirm

14. Users (4 commands)#

Get current user info, list emails, and look up other users.

CommandDescriptionuser-get-currentGet the authenticated useruser-emailsList your email addressesuser-email-getGet a specific email addressuser-getGet a user by UUID or usernamebash

# Get current user info
bitbucket user-get-current

# List your emails
bitbucket user-emails

# Look up another user
bitbucket user-get --user-uuid {uuid}

15. SSH Keys (5 commands)#

Manage SSH keys on your Bitbucket account.

CommandDescriptionssh-key-listList SSH keysssh-key-getGet an SSH keyssh-key-createAdd an SSH keyssh-key-updateUpdate an SSH key labelssh-key-deleteDelete an SSH keybash

# List SSH keys
bitbucket ssh-key-list

# Add an SSH key
bitbucket ssh-key-create --key "ssh-ed25519 AAAA..." --label "work laptop"

# Delete an SSH key (requires --confirm)
bitbucket ssh-key-delete --key-id 123 --confirm

16. GPG Keys (4 commands)#

Manage GPG keys for commit signature verification.

CommandDescriptiongpg-key-listList GPG keysgpg-key-getGet a GPG keygpg-key-createAdd a GPG keygpg-key-deleteDelete a GPG keybash

# List GPG keys
bitbucket gpg-key-list

# Add a GPG key
bitbucket gpg-key-create --key "-----BEGIN PGP PUBLIC KEY BLOCK-----..."

# Delete a GPG key (requires --confirm)
bitbucket gpg-key-delete --key-id abc123 --confirm

17. Source / File Browsing (4 commands)#

Browse repository source files and commit new files.

CommandDescriptionsrc-historyGet file historysrc-rootList files at the repo root (or a path)src-createCreate/update a file via commitsrc-getGet file contentsbash

# List files at root
bitbucket src-root -w myworkspace -r my-repo

# Get file contents
bitbucket src-get -w myworkspace -r my-repo --path src/index.js

# Get file history
bitbucket src-history -w myworkspace -r my-repo --path README.md

# Create/update a file
bitbucket src-create -w myworkspace -r my-repo \
  --path config.yml --message "Add config" --file ./config.yml

18. Downloads (4 commands)#

Manage repository download artifacts.

CommandDescriptiondownload-listList downloadsdownload-getGet a downloaddownload-uploadUpload a download artifactdownload-deleteDelete a downloadbash

# List downloads
bitbucket download-list -w myworkspace -r my-repo

# Upload an artifact
bitbucket download-upload -w myworkspace -r my-repo --file ./release-v1.0.zip

# Delete a download (requires --confirm)
bitbucket download-delete -w myworkspace -r my-repo --filename release-v1.0.zip --confirm

19. Webhooks (2 commands)#

Discover available webhook event types.

CommandDescriptionwebhook-eventsList all webhook event subjectswebhook-event-typesList event types for a subjectbash

# List webhook event subjects
bitbucket webhook-events

# List event types for a subject
bitbucket webhook-event-types --subject repository

20. Search (3 commands)#

Search code, accounts, and teams.

CommandDescriptionsearch-codeSearch for code in a workspacesearch-accountSearch for accountssearch-teamSearch for teamsbash

# Search code
bitbucket search-code -w myworkspace --search-query "import express"

# Search for an account
bitbucket search-account --search-query "john"

21. Reports (9 commands)#

Manage commit reports and annotations (code quality, security, etc.).

CommandDescriptionreport-listList reports on a commitreport-getGet a reportreport-createCreate a reportreport-deleteDelete a reportreport-annotation-listList report annotationsreport-annotation-getGet a report annotationreport-annotation-createCreate an annotationreport-annotation-bulk-createBulk create annotationsreport-annotation-deleteDelete an annotationbash

# Create a code quality report
bitbucket report-create -w myworkspace -r my-repo --commit abc123 \
  --report-id lint-report --title "ESLint" --report-type BUG \
  --data '{"result":"PASSED"}'

# Add annotations to a report
bitbucket report-annotation-bulk-create -w myworkspace -r my-repo \
  --commit abc123 --report-id lint-report \
  --data '[{"path":"src/app.js","line":42,"message":"Unused variable","severity":"MEDIUM"}]'

# List reports on a commit
bitbucket report-list -w myworkspace -r my-repo --commit abc123

22. Properties (12 commands)#

Get, set, and delete application properties on commits, repos, PRs, and users.

CommandDescriptioncommit-property-getGet a commit propertycommit-property-updateSet a commit propertycommit-property-deleteDelete a commit propertyrepo-property-getGet a repo propertyrepo-property-updateSet a repo propertyrepo-property-deleteDelete a repo propertypr-property-getGet a PR propertypr-property-updateSet a PR propertypr-property-deleteDelete a PR propertyuser-property-getGet a user propertyuser-property-updateSet a user propertyuser-property-deleteDelete a user propertybash

# Set a repo property
bitbucket repo-property-update -w myworkspace -r my-repo \
  --app-key myapp --property-name env --data '{"tier":"production"}'

# Get a repo property
bitbucket repo-property-get -w myworkspace -r my-repo \
  --app-key myapp --property-name env

# Delete a PR property (requires --confirm)
bitbucket pr-property-delete -w myworkspace -r my-repo --pr-id 42 \
  --app-key myapp --property-name review-status --confirm

23. Addon (10 commands)#

Manage Bitbucket Connect addon lifecycle, linkers, and linker values.

CommandDescriptionaddon-deleteUninstall the addonaddon-updateUpdate the addon descriptoraddon-linkersList addon linkersaddon-linker-getGet an addon linkeraddon-linker-values-deleteDelete all linker valuesaddon-linker-valuesList linker valuesaddon-linker-value-createCreate a linker valueaddon-linker-value-updateUpdate a linker valueaddon-linker-value-deleteDelete a linker valueaddon-linker-value-getGet a linker valuebash

# List addon linkers
bitbucket addon-linkers

# Create a linker value
bitbucket addon-linker-value-create --linker-key my-linker \
  --data '{"key":"issue-42","href":"https://tracker.example.com/42"}'

# Delete a linker value (requires --confirm)
bitbucket addon-linker-value-delete --linker-key my-linker --value-id 42 --confirm

Security#

• Auth method: Basic auth with App Passwords (BITBUCKET_USERNAME + BITBUCKET_APP_PASSWORD)
• No secrets or tokens printed to stdout
• All delete operations require explicit --confirm flag
• Path traversal prevention for file uploads ( safePath())
• Built-in rate limiting with exponential backoff retry (3 attempts)
• File size validation before upload
• Lazy config validation (only checked when a command runs)

Dependencies#

• commander — CLI framework
• dotenv — environment variable loading
• Node.js built-in fetch (requires Node >= 18)

Author#

Abdelkrim BOUJRAF — ALT-F1 SRL, Brussels X: @altf1be