Bitbucket with orbit CLI

Manage Bitbucket repositories, pull requests, branches, tags, commits, projects, and users through the

orbit

CLI. Works with both Bitbucket Server/Data Center and Cloud, with multi-profile support and 1Password secret resolution.

Prerequisites

```
orbit
```
binary built and accessible
A profile with a
```
bitbucket
```
service configured in
```
~/.config/orbit/config.yaml
```
Valid credentials (Personal Access Token or Bearer token for Server; app password for Cloud) — can be stored in 1Password with
```
op://
```
prefix

Quick Reference

All commands follow the pattern:

orbit -p <profile> bitbucket <command> [flags]

Alias:

orbit -p <profile> bb <command> [flags]

All commands support

-o json

for JSON output. For full command details and all flags, see

references/commands.md

Addressing Convention

Bitbucket Server/Data Center uses project-key + repo-slug to identify repositories. These are the two positional arguments most commands require:

Project key: uppercase short code (e.g.,
```
L3SUP
```
,
```
MYPROJ
```
)
Repo slug: lowercase hyphenated name (e.g.,
```
agents-sre
```
,
```
my-service
```
)

You can extract these from a Bitbucket Server URL:

https://git.example.com/projects/L3SUP/repos/agents-sre/
                                  ^^^^^       ^^^^^^^^^^
                              project-key     repo-slug

Core Workflows

Exploring Projects and Repos

bash

# List all projects
orbit -p myprofile bb project list

# View project details
orbit -p myprofile bb project view L3SUP

# List repositories in a project
orbit -p myprofile bb repo list L3SUP

# View repo details (includes clone URLs)
orbit -p myprofile bb repo view L3SUP agents-sre

Working with Pull Requests

Bitbucket uses "pull requests" (PR), same as GitHub.

bash

# List open PRs (default)
orbit -p myprofile bb pr list L3SUP agents-sre

# List merged PRs
orbit -p myprofile bb pr list L3SUP agents-sre --state merged

# List all PRs
orbit -p myprofile bb pr list L3SUP agents-sre --state all

# View PR details (shows from/to branches, reviewers, approval status)
orbit -p myprofile bb pr view L3SUP agents-sre 42

# Create a PR
orbit -p myprofile bb pr create L3SUP agents-sre \
  --from feature/new --to main --title "Add new feature"

# Create a PR with reviewers
orbit -p myprofile bb pr create L3SUP agents-sre \
  --from feature/new --to main --title "Add feature" \
  --reviewers john.doe,jane.smith

# View PR diff (for code review)
orbit -p myprofile bb pr diff L3SUP agents-sre 42

# View PR diff with more context lines
orbit -p myprofile bb pr diff L3SUP agents-sre 42 --context 10

# Merge a PR
orbit -p myprofile bb pr merge L3SUP agents-sre 42

# Merge a PR bypassing review checks (requires repo admin)
orbit -p myprofile bb pr merge L3SUP agents-sre 42 --bypass-review

# Decline a PR
orbit -p myprofile bb pr decline L3SUP agents-sre 42

# Add a comment to a PR
orbit -p myprofile bb pr comment L3SUP agents-sre 42 --body "LGTM!"

# View PR activity (comments, approvals, status changes)
orbit -p myprofile bb pr activity L3SUP agents-sre 42

PR states:

OPEN

MERGED

DECLINED

ALL

Branches and Tags

bash

# List branches
orbit -p myprofile bb branch list L3SUP agents-sre

# Filter branches by name
orbit -p myprofile bb branch list L3SUP agents-sre --filter feature

# Show default branch
orbit -p myprofile bb branch default L3SUP agents-sre

# Create a branch from a ref
orbit -p myprofile bb branch create L3SUP agents-sre feature/new-thing main

# Delete a branch
orbit -p myprofile bb branch delete L3SUP agents-sre feature/old-thing

# List tags
orbit -p myprofile bb tag list L3SUP agents-sre

# Create a tag
orbit -p myprofile bb tag create L3SUP agents-sre v1.0.0 main -m "Release v1.0.0"

Commits

bash

# List recent commits (default branch)
orbit -p myprofile bb commit list L3SUP agents-sre

# List commits on a specific branch
orbit -p myprofile bb commit list L3SUP agents-sre --branch feature/new

# View commit details
orbit -p myprofile bb commit view L3SUP agents-sre abc1234def5678

Users

bash

# List users
orbit -p myprofile bb user list

# Filter users by name
orbit -p myprofile bb user list --filter john

Common Patterns

Get JSON for scripting:

bash

orbit -p myprofile bb pr list L3SUP agents-sre -o json | jq '.[].title'

Review a PR end-to-end:

bash

# View PR details and reviewers
orbit -p myprofile bb pr view L3SUP agents-sre 42
# Get the full diff for code review
orbit -p myprofile bb pr diff L3SUP agents-sre 42
# Check activity (approvals, comments)
orbit -p myprofile bb pr activity L3SUP agents-sre 42
# Add your review comment
orbit -p myprofile bb pr comment L3SUP agents-sre 42 --body "Approved, looks good"

Extract project key and repo slug from a URL: Given

https://git.cnvrmedia.net/projects/L3SUP/repos/agents-sre/pull-requests

Project key:
```
L3SUP
```

Repo slug:

agents-sre

Then run:

orbit -p myprofile bb pr list L3SUP agents-sre

Check what repos exist in a project:

bash

orbit -p myprofile bb repo list L3SUP

Important Notes

Profile required — Always pass
```
-p <profile>
```
to select the Bitbucket connection. The profile must have a service of type
```
bitbucket
```
configured.
Service flag — If a profile has multiple Bitbucket services, use
```
--service <name>
```
to disambiguate.
Server vs Cloud — The service variant (
```
server
```
or
```
cloud
```
) in config determines the API prefix. Server uses
```
/rest/api/latest/
```
, Cloud uses
```
/2.0/
```
.
1Password integration — Auth tokens in config can use
```
op://vault/item/field
```
and are resolved at runtime. Run
```
orbit auth
```
once to resolve and cache all secrets for 8 hours (single biometric prompt). Use
```
orbit auth clear
```
to wipe the cache.
PR states are uppercase — Use
```
OPEN
```
,
```
MERGED
```
,
```
DECLINED
```
, or
```
ALL
```
(case-insensitive input is accepted).
Pagination — Most list commands default to 25-50 results. Use
```
--limit N
```
to adjust.
URL parsing — When a user provides a Bitbucket Server URL like
```
https://host/projects/KEY/repos/SLUG/...
```
, extract the project key and repo slug from the URL path to use with orbit commands.

bitbucket

NPX Install

Tags

SKILL.md Content

Bitbucket with orbit CLI

Prerequisites

Quick Reference

Addressing Convention

Core Workflows

Exploring Projects and Repos

Working with Pull Requests

Branches and Tags

Commits

Users

Common Patterns

Important Notes