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 (including navigation keys), JQL tabs, issue columns, custom fields
• Themes - default ANSI palette plus all four Catppuccin flavors (Latte, Frappé, Macchiato, Mocha)
• Adaptive - side-by-side or stacked layout, mouse support

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";

let
  version = "...";
  src =
    fetchFromGitHub {
      owner = "textfuel";
      repo = "lazyjira";
      tag = "v${version}";
      hash = "...";
    };

  buildGoApplication = import "${src}/nix/build-go-application.nix" system;
in
callPackage "${src}/nix/package.nix" { inherit buildGoApplication version; }

sudo dpkg -i lazyjira_*.deb

sudo rpm -i lazyjira_*.rpm

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

go install github.com/textfuel/lazyjira/v2/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.

Themes

lazyjira supports the default ANSI 16 palette, Catppuccin presets, auto light/dark selection, and custom palette overrides. Set gui.theme in ~/.config/lazyjira/config.yml:

gui:
  theme: catppuccin-mocha

See the Themes docs for supported values, palette overrides, and examples.

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
• Configurable navigation keys
• Searchable keybindings help popup
• Scroll detail panel without switching focus
• Create subtasks from TUI
• Link issues (add/remove issue links)
• CLI mode (non-interactive commands for scripting and automation)
• Robust issue type changer (handle subtask/parent unlinking, field validation)
• Clickable hyperlinks in terminal (OSC 8) for URLs in descriptions and comments
• Catppuccin Theming
• Custom colors theming, date format, languages
• 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