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.
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.5.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
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.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file bitbucket_jira_cli-1.5.0.tar.gz.
File metadata
- Download URL: bitbucket_jira_cli-1.5.0.tar.gz
- Upload date:
- Size: 1.6 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fa725b929c46b680e99d4c96868344694a09938e3594fcebb83e069977a46b7d
|
|
| MD5 |
50d6f6231ef26b15d9726bcc57a83400
|
|
| BLAKE2b-256 |
db69cdf808ed63ad87ebf94e3550d76c128d8e03e954226fa5bd63359b1708b1
|
File details
Details for the file bitbucket_jira_cli-1.5.0-py3-none-any.whl.
File metadata
- Download URL: bitbucket_jira_cli-1.5.0-py3-none-any.whl
- Upload date:
- Size: 83.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d090eb0d1052a5da3ba58ab4cb8ff283030106ec27e30f0a8c1227d8294a691e
|
|
| MD5 |
8c630f93cae31a542c7576e6bde4bc5c
|
|
| BLAKE2b-256 |
364d1aac59a2232f6ad58995687867247019f3b95a30b088725fc7ad43580d9d
|
