Installation¶

Note

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.

Recommended: one-line install (uv)¶

The install script sets up an isolated, self-updating CLI via uv. No virtualenv juggling.

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.2/install.sh | sh

Alternatives¶

PyPI (pip or uv)¶

# Install as an isolated tool…
uv tool install bitbucket-jira-cli

# …or run it once without installing:
uvx bitbucket-jira-cli --help

# …or with pip:
pip install bitbucket-jira-cli

Docker¶

docker pull spenhouet/bitbucket-jira-cli:latest
docker run --rm spenhouet/bitbucket-jira-cli --help

Verify¶

bj --help
bj --version