jira-tui

A Textual terminal user interface (TUI) that wraps jira-cli so you can execute common JIRA workflows without leaving the terminal. The application checks that jira-cli is configured, offers shortcuts for day-to-day actions (listing, viewing, creating and updating issues) and exposes a terminal window for interactive commands such as jira init or jira issue create.

Getting started

python -m venv .venv
source .venv/bin/activate
pip install -e .
jira-tui

Requirements

• Python 3.11+
• jira-cli installed and available on PATH

When jira-tui launches it verifies that jira is available. If the configuration is missing, press g to open an interactive session running jira init.

Key bindings (MVP)

Key	Action
g	Run jira init inside the embedded terminal
R	Re-check authentication status
/	Execute a JQL search (jira issue list --jql ... --plain)
i	List issues assigned to you
v	View issue details
c	Run jira issue create in the embedded terminal
C	Add a comment to an issue
t	Transition an issue to a new state
?	Display available shortcuts in the log
q	Quit the application

Roadmap / Task list

• Package skeleton with Textual dependency and CLI entrypoint
• Configuration status check with jira me
• Embedded terminal for interactive commands (jira init, jira issue create)
• Keyboard shortcuts for common flows (list/view/comment/transition)
• Persist user preferences (favourite JQLs, default project)
• Dedicated panes for issue lists and detailed views
• Tests (mocked subprocess calls)
• Richer error handling for non-zero exit codes
• Configurable key bindings and command palette

Development

Run linting (optional if ruff is installed):

ruff check .

Launch the TUI in development mode with live reload:

textual run --dev jira_tui.app:JiraTUIApp