skill

bitbucket-jira-cli

The gh CLI experience, for Bitbucket and Jira

Spenhouet/bitbucket-jira-clicommunitylistedunreviewed

Set up

Skills are installed by placing their folder where your agent loads skills.

Download ZIP from GitHub Open the repository

The download comes from github.com/Spenhouet/bitbucket-jira-cli itself, not from our server, so what you get is exactly what its author published.

Install instructions come from the README

Skills do not use an MCP config. Follow the steps in the README below.

README

synced Oct 25, 2026

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.

Requirements

bj works with Bitbucket Cloud and Jira Cloud. Bitbucket and Jira Server or Data Center are not supported yet. Contributions to add on-prem support are welcome.

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.9.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.

Quick demo

Create a Jira issue, open a branch for it, and open a linked pull request, without leaving the terminal.

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.