bitbucket-jira-cli

name

bitbucket-jira-cli

description

Manage Bitbucket pull requests, repositories, and pipelines and Jira issues from the terminal with the bj CLI. bj mirrors the GitHub gh CLI, so gh pr/issue/repo commands map to bj pr/issue/repo, no MCP server or API wiring needed. Installs the bj CLI automatically if it is missing. Use when working with Bitbucket or Jira, opening or reviewing pull requests, managing Jira issues, running pipelines, or when a git branch name contains a Jira issue key like PROJ-42.

bitbucket-jira-cli (bj)

bj is gh for Bitbucket and Jira. The command surface mirrors the GitHub CLI: if you know gh, you know bj. It manages Bitbucket pull requests, repositories, and pipelines, plus Jira issues, from one noun-first command tree.

If a command or flag is not covered here, run bj <command> --help; the flags mirror gh and the help is authoritative.

Install bj if it is missing

Before running any bj command, make sure the CLI is on PATH. If command -v bj finds nothing, install it. This snippet picks whatever installer is already available and prefers an isolated, self-updating install:

if ! command -v bj >/dev/null 2>&1; then
  if command -v uv >/dev/null 2>&1; then
    uv tool install bitbucket-jira-cli          # isolated, self-updating (preferred)
  elif command -v pipx >/dev/null 2>&1; then
    pipx install bitbucket-jira-cli
    -v pip3 >/dev/null 2>&1 ||  -v pip >/dev/null 2>&1; 
    pip install --user bitbucket-jira-cli
  
    curl -LsSf uvx.sh/bitbucket-jira-cli/install.sh | sh