Skip to content

Bitbucket Jira CLI

Introduction

Spenhouet/bitbucket-jira-cli

Bitbucket Jira CLI

Spenhouet/bitbucket-jira-cli

Home
Introduction Introduction
On this page
- Next steps
Getting started
Getting started
- Installation
- Usage
Guides
Guides
Command reference
Command reference
- Overview
- bj auth
  bj auth
  - Overview
  - login
  - status
  - logout
  - token
  - setup-git
  - git-credential
- bj repo
  bj repo
  - Overview
  - view
  - list
  - clone
  - set-default
  - create
  - fork
  - delete
  - edit
  - rename
  - file
  - ls
  - deploy-key
- bj pr
  bj pr
  - Overview
  - create
  - edit
  - list
  - view
  - diff
  - status
  - checkout
  - merge
  - review
  - comment
  - close
  - checks
  - ready
  - reopen
  - task
- bj issue
  bj issue
  - Overview
  - fields
  - list
  - view
  - create
  - edit
  - comment
  - transition
  - close
  - develop
  - delete
  - status
- bj release
  bj release
  - Overview
  - list
  - view
  - create
  - edit
  - release
  - unrelease
  - delete
- bj board
  bj board
  - Overview
  - list
  - sprints
- bj pipeline
  bj pipeline
  - Overview
  - list
  - view
  - logs
  - run
  - stop
  - watch
  - rerun
- bj variable
  bj variable
  - Overview
  - list
  - set
  - delete
- bj search
  bj search
  - Overview
  - repos
  - code
  - issues
- bj status
- bj config
  bj config
  - Overview
  - list
  - get
  - set
- bj alias
  bj alias
  - Overview
  - set
  - list
  - delete
- bj ssh-key
  bj ssh-key
  - Overview
  - list
  - add
  - delete
- bj skill
  bj skill
  - Overview
  - install
- bj snippet
  bj snippet
  - Overview
  - list
  - create
  - view
  - delete
- bj ruleset
  bj ruleset
  - Overview
  - list
- bj browse
- bj api
Contributing

Bitbucket Jira CLI (`bj`)¶

bj is a command-line tool that brings GitHub gh ergonomics to Bitbucket and Jira. It manages Bitbucket pull requests, repos and pipelines and Jira issues from one noun-first command surface. It is terminal-native and scriptable, which makes it a natural fit for 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. See the branch-key workflow guide.

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.

Next steps¶

Installation: install with uv, pip, or Docker.
Usage: the three-step flow.
Guides: branch keys, coding agents, configuration, output formatting.
Command reference: every command, generated from the CLI.