bitbucket

Bitbucket CLI

Manage Bitbucket Cloud (bitbucket.org) and Server/Data Center from the command line.

Auto-detects platform from BITBUCKET_URL. For Cloud, use workspace as the first argument (e.g., myteam from bitbucket.org/myteam/my-repo).

Setup

cd /path/to/skills/bitbucket
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
cp .env.example .env   # then edit .env with your credentials
.venv/bin/python3 -m scripts workspaces list   # verify

Cloud needs BITBUCKET_URL=https://bitbucket.org + BITBUCKET_USERNAME + BITBUCKET_API_TOKEN (App Password). Server needs BITBUCKET_URL + BITBUCKET_PAT_TOKEN.

CLI Commands

All commands run from the skill directory. Pattern: .venv/bin/python3 -m scripts <resource> <action> [args] [--flags]

# Workspaces / Projects
.venv/bin/python3 -m scripts workspaces list

# Repositories
.venv/bin/python3 -m scripts repos list myteam

# Pull Requests
.venv/bin/python3 -m scripts pr list myteam my-repo [--state=OPEN] [--limit=25]
.venv/bin/python3 -m scripts pr get myteam my-repo 123
.venv/bin/python3 -m scripts pr create myteam my-repo "Title" source-branch target-branch [--desc=...] [--reviewers=a,b]
.venv/bin/python3 -m scripts pr merge myteam my-repo 123 [--strategy=squash]
.venv/bin/python3 -m scripts pr decline myteam my-repo 123
.venv/bin/python3 -m scripts pr comment myteam my-repo 123 "LGTM!"
.venv/bin/python3 -m scripts pr diff myteam my-repo 123

# Commits
.venv/bin/python3 -m scripts commits list myteam my-repo [--branch=main] [--limit=10]
.venv/bin/python3 -m scripts commits get myteam my-repo abc123def

# Files
.venv/bin/python3 -m scripts files get myteam my-repo src/main.py [--branch=main]
.venv/bin/python3 -m scripts files search "query" [--workspace=myteam] [--repo=my-repo]

All output is JSON to stdout. Errors go to stderr with non-zero exit code.

Error Handling

Errors return: {"success": false, "error": "message", "error_type": "AuthenticationError"}

Types: ConfigurationError, AuthenticationError, ValidationError, NotFoundError, APIError, NetworkError.

Python API

See REFERENCE.md for using as a Python library with direct function calls.