lazyjira

Terminal UI for Jira. Like lazygit but for Jira.

Jira's web UI is painfully slow. Changing a ticket status takes multiple clicks, pages take seconds to load, and you spend more time fighting the interface than actually working. lazyjira gives you a fast, keyboard-driven terminal UI so you can browse issues, update statuses, read descriptions and more with minimum latency.

Demo mode

Try without a Jira account (build from source required):

make build-demo
./lazyjira --demo

Features

• JQL search with autocomplete, syntax highlighting, and persistent history
• 4-panel layout - issues, projects, detail, status - with vim-style navigation
• Inline editing - transitions, priority, assignee, labels, comments, description ($EDITOR)
• Configurable - custom keybindings, JQL tabs, issue columns, custom fields
• Adaptive - side-by-side or stacked layout, mouse support, ANSI 16 colors

Installation

brew install textfuel/tap/lazyjira

yay -S lazyjira-bin     # prebuilt binary
yay -S lazyjira-git     # build from source

nix run github:textfuel/lazyjira

inputs.lazyjira.url = "github:textfuel/lazyjira";

sudo dpkg -i lazyjira_*.deb

sudo rpm -i lazyjira_*.rpm

sudo apk add --allow-untrusted lazyjira_*.apk

go install github.com/textfuel/lazyjira/cmd/lazyjira@latest

git clone https://github.com/textfuel/lazyjira.git
cd lazyjira
make build

Setup

Run lazyjira. On first launch the setup wizard asks for your Jira type (Cloud or Server/Data Center), host, and credentials.

Jira Cloud

Provide your email and an API token (also called Personal Access Token / PAT).

Create one at https://id.atlassian.com/manage-profile/security/api-tokens

Jira Server / Data Center

Provide your Personal Access Token (PAT). No email needed.

Generate a PAT in Jira: Profile > Personal Access Tokens > Create token.

For environments that require client certificates (mTLS), see Configuration.

Credentials saved to ~/.config/lazyjira/auth.json.

Usage

lazyjira                 # start
lazyjira auth            # re-authenticate
lazyjira logout          # clear credentials
lazyjira --dry-run       # read-only mode (no writes to Jira)
lazyjira --log app.log   # log API requests to file
lazyjira --version       # show version

Press ? inside the app for all keybindings.

Documentation

• Configuration - config file, keybindings, issue tabs, custom fields, git integration
• Keybindings - full list of default keys
• Custom Fields - displaying Jira custom fields

Roadmap

• Robust JQL search
• Git integration, create branches from issues, open issue from current branch
• Jira Server and Data Center support
• Client certificate authentication (mTLS)
• Create issues
• Robust issue type changer (handle subtask/parent unlinking, field validation)
• Clickable hyperlinks in terminal (OSC 8) for URLs in descriptions and comments
• Theming, borders, date format, language and other GUI options
• Mouse support toggle
• Show icons toggle
• Cache with configurable TTL
• Auto-refresh with configurable interval
• Custom field type handling (select, multiselect, user)
• Board ID per project
• Rich text editing, colors, panels, media in ADF descriptions
• Bulk operations, transition and assign multiple issues at once
• Notifications, watch for issue updates
• Offline mode, cached view when network is unavailable

Star History

License

MIT