Jira CLI

Think github-cli but for Jira.

Modular, class-based Jira command-line tool for issue listing, searching, and management.

There's a CLI (jira issue ...) and an interactive TUI (jira tui --project PROJ). Both are self-explanatory via --help / the in-app ? help — see docs/features.md for the full feature overview and TUI keyboard shortcuts.

Installation

# Editable install for local development
uv tool install --editable .
jira --help

# Remote/published, via uvx
uvx --from colenio-jira-cli jira-cli issue list --project PROJ

The PyPI/package name is colenio-jira-cli; the installed commands are jira and jira-cli (both run the same CLI). See docs/distribution.md for other install options (pip, venv).

For screenshots, screencasts, or trying the TUI without Jira credentials, use synthetic demo data:

jira tui --demo

Screenshots

The default issue table is optimized for quick triage: type, key, summary, status, assignee, and priority stay visible while the detail pane follows the current selection.

The board view groups the same issue source by workflow status, with Backlog on the left and done states on the right.

Setup

Create a .env or local.env file in your working directory (auto-discovered in CWD or parent directories):

# Required
JIRA_URL=https://company.atlassian.net
JIRA_EMAIL=user@example.com
JIRA_API_TOKEN=your_api_token_here

# Optional
JIRA_PROJECT=PROJ      # Default project for list/find/tui

Get your API token from Jira Cloud: Account Settings → Security → Create API Token.

Development

uv sync --extra dev --extra local-dev
uv run pytest
uv run black jira_cli
uv run ruff check jira_cli
uv run jira-cli-qa   # runs ruff + radon + pylint

Documentation Site

uv sync --extra docs
uv run jira-cli-docs        # strict MkDocs build
uv run jira-cli-docs-serve  # local preview

The docs are built with MkDocs Material and mkdocstrings. API pages render Python docstrings directly from jira_cli.

Additional Docs

• docs/features.md — feature overview + TUI keyboard shortcuts
• docs/architecture.md
• docs/distribution.md

License

MIT