bitbucket-jira-cli 1.0.0

A gh-style CLI for Bitbucket (PRs, repos, pipelines) and Jira (issues), with branch-name-as-Jira-key automation

A gh-style CLI for Bitbucket (pull requests, repos, pipelines) and Jira (issues), with branch-name-as-Jira-key automation.

What it does

bj brings GitHub gh ergonomics to Bitbucket and Jira. It manages Bitbucket pull requests, repositories and pipelines and Jira issues from a single noun-first command surface.

The signature feature is branch-name-as-Jira-key: your current git branch carries a Jira key (e.g. feature/PROJ-42-thing), and commands use it to auto-link pull requests to tickets and drive Jira transitions.

Quickstart

1. Install

macOS and Linux

curl -LsSf uvx.sh/bitbucket-jira-cli/install.sh | sh

Windows

powershell -ExecutionPolicy ByPass -c "irm https://uvx.sh/bitbucket-jira-cli/install.ps1 | iex"

Installing a specific version:

curl -LsSf uvx.sh/bitbucket-jira-cli/1.0.0/install.sh | sh

Alternative install methods (PyPI via pip / uv, prebuilt Docker image) are covered in the installation docs.

2. Authenticate

bj auth login

3. Use it

# On a branch like feature/PROJ-42-thing:
bj pr create          # open a PR, auto-linked to PROJ-42
bj pr view            # show the PR for the current branch
bj issue view PROJ-42 # show the Jira issue
bj pipeline list      # list Bitbucket Pipelines runs

Documentation

The full documentation lives at https://spenhouet.github.io/bitbucket-jira-cli/.

Contributing

If you would like to contribute, please read our contribution guideline.

License

This tool is an open source project released under the MIT License.