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.8.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
Metadata
1 maintainer
Release files for bitbucket-jira-cli 1.8.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| bitbucket_jira_cli-1.8.0.tar.gz | 1.6 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| bitbucket_jira_cli-1.8.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.7 MB
Release files / bitbucket_jira_cli-1.8.0.tar.gz
| Download URL | bitbucket_jira_cli-1.8.0.tar.gz |
|---|---|
| Size | 1.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bf3837203b6bf7ba730f340bce3152dad5d60ec52c6a88e242ca38ab6f5871aa
|
|
BLAKE2b-256 checksum How to use checksums |
baa98971198902f3dc7ec10f2e6a7e313b2656a8089033ad8aa4f671d11db09a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","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}
|
Release files / bitbucket_jira_cli-1.8.0-py3-none-any.whl
| Download URL | bitbucket_jira_cli-1.8.0-py3-none-any.whl |
|---|---|
| Size | 95.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
977bad56f7a890e840aa47205682690909d20cc694667dc68da11f1b56a90e6d
|
|
BLAKE2b-256 checksum How to use checksums |
4ba27d24c88279e38a2ac0e21ba98cceb83a797d0635e0b4db91afe5a06ae233
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","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}
|
