bj¶

A gh-style CLI for Bitbucket (PRs, repos, pipelines) and Jira (issues).

Synopsis¶

bj <command> [OPTIONS]

Description¶

bj brings the ergonomics of GitHub's gh CLI to Bitbucket Cloud and Jira Cloud. It manages Bitbucket pull requests, repositories and pipelines and Jira issues from a single noun-first command surface, and reads the Jira key from your git branch to auto-link and transition tickets. It works with Bitbucket Cloud and Jira Cloud; Server and Data Center are not supported yet. See the branch-key workflow guide.

Core commands¶

Command	Description
`bj auth`	Authenticate bj with Bitbucket and Jira.
`bj repo`	Work with Bitbucket repositories.
`bj pr`	Manage Bitbucket pull requests.
`bj issue`	Manage Jira issues.

Jira planning¶

Command	Description
`bj release`	Manage Jira project versions (releases).
`bj board`	Work with Jira boards and sprints (needs an unscoped Jira token).

Pipelines¶

Command	Description
`bj pipeline`	Work with Bitbucket Pipelines.
`bj variable`	Manage Bitbucket Pipelines variables (use --secured for secrets).

Search and status¶

Command	Description
`bj search`	Search Bitbucket and Jira.
`bj status`	Show a dashboard: your open Jira issues and the current repo's open PRs.

Configuration¶

Command	Description
`bj config`	Read and write bj configuration.
`bj alias`	Create command shortcuts.
`bj ssh-key`	Manage your Bitbucket account SSH keys.

Utility¶

Command	Description
`bj skill`	Install the bj agent skill into a coding agent (mirrors `gh skill`).
`bj snippet`	Work with Bitbucket snippets.
`bj ruleset`	Inspect Bitbucket branch restrictions.
`bj browse`	Open the repository, current PR, or branch's Jira issue in the browser.
`bj api`	Make an authenticated request to the Bitbucket or Jira API.

Options¶

Option	Description
`--version`	Show the version and exit.
`--install-completion`	Install completion for the current shell.
`--show-completion`	Show completion for the current shell, to copy it or customize the installation.