bitbucket-jira-cli 1.0.1

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. It is terminal-native and scriptable, so it pairs well with AI coding agents (see Coding agents).

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.1/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

4. Use it with AI agents (optional)

bj ships an agent skill, so AI coding agents (Claude Code, Copilot, Cursor, Codex, Gemini CLI) can drive it the way they drive gh. Install it like gh skill install, but from the package you already have:

bj skill install --agent claude-code

See the Coding agents guide.

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.