Metadata-Version: 2.4
Name: bitbucket-jira-cli
Version: 1.0.1
Summary: A gh-style CLI for Bitbucket (PRs, repos, pipelines) and Jira (issues), with branch-name-as-Jira-key automation
Project-URL: Homepage, https://github.com/Spenhouet/bitbucket-jira-cli
Project-URL: Documentation, https://spenhouet.github.io/bitbucket-jira-cli/
Project-URL: Source, https://github.com/Spenhouet/bitbucket-jira-cli
Project-URL: Tracker, https://github.com/Spenhouet/bitbucket-jira-cli/issues
Author: Sebastian Penhouet
License: MIT
License-File: LICENSE
Keywords: atlassian,bitbucket,cli,gh,jira,pull-request
Requires-Python: >=3.10
Requires-Dist: httpx
Requires-Dist: keyring
Requires-Dist: pydantic-settings
Requires-Dist: python-dateutil
Requires-Dist: pyyaml
Requires-Dist: questionary
Requires-Dist: rich
Requires-Dist: tabulate
Requires-Dist: typer
Description-Content-Type: text/markdown

<p align="center">
  <a href="https://github.com/Spenhouet/bitbucket-jira-cli"><img src="https://raw.githubusercontent.com/Spenhouet/bitbucket-jira-cli/main/static/img/banner.png" style="border-radius: 15px;" alt="bitbucket-jira-cli"></a>
</p>
<p align="center">
  <em>A gh-style CLI for Bitbucket (pull requests, repos, pipelines) and Jira (issues), with branch-name-as-Jira-key automation.</em>
</p>
<p align="center">
  <a href="https://github.com/Spenhouet/bitbucket-jira-cli/actions/workflows/python-build.yml"><img src="https://github.com/Spenhouet/bitbucket-jira-cli/actions/workflows/python-build.yml/badge.svg" alt="Build Python package"></a>
  <a href="https://github.com/Spenhouet/bitbucket-jira-cli/actions/workflows/release.yml"><img src="https://github.com/Spenhouet/bitbucket-jira-cli/actions/workflows/release.yml/badge.svg" alt="Build and publish to PyPI"></a>
  <a href="https://pypi.org/project/bitbucket-jira-cli" target="_blank">
    <img src="https://img.shields.io/pypi/v/bitbucket-jira-cli?color=%2334D058&label=PyPI%20package" alt="PyPI version">
   </a>
  <a href="https://hub.docker.com/r/spenhouet/bitbucket-jira-cli" target="_blank">
    <img src="https://img.shields.io/docker/v/spenhouet/bitbucket-jira-cli?sort=semver&label=Docker%20Hub&color=2496ED&logo=docker&logoColor=white" alt="Docker Hub version">
   </a>
  <a href="https://spenhouet.github.io/bitbucket-jira-cli/" target="_blank">
    <img src="https://img.shields.io/badge/docs-online-blue" alt="Documentation">
   </a>
</p>

## What it does

`bj` brings [GitHub `gh`](https://cli.github.com/) 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](https://spenhouet.github.io/bitbucket-jira-cli/guides/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.

## Quickstart

### 1. Install

**macOS and Linux**

```bash
curl -LsSf uvx.sh/bitbucket-jira-cli/install.sh | sh
```

**Windows**

```powershell
powershell -ExecutionPolicy ByPass -c "irm https://uvx.sh/bitbucket-jira-cli/install.ps1 | iex"
```

Installing a specific version:

```bash
curl -LsSf uvx.sh/bitbucket-jira-cli/1.0.1/install.sh | sh
```

Alternative install methods (PyPI via `pip` / `uv`, prebuilt Docker image) are
covered in the [installation docs](https://spenhouet.github.io/bitbucket-jira-cli/installation).

### 2. Authenticate

```sh
bj auth login
```

### 3. Use it

```sh
# 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](https://agentskills.io/), 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:

```sh
bj skill install --agent claude-code
```

See the [Coding agents](https://spenhouet.github.io/bitbucket-jira-cli/guides/agents)
guide.

## 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](CONTRIBUTING.md).

## License

This tool is an open source project released under the [MIT License](LICENSE).
