Skip to content

textfuel/lazyjira

Repository files navigation

Go Release License: MIT

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.

preview preview vertical

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

macOS

Homebrew

brew install textfuel/tap/lazyjira
Linux

Arch Linux (AUR)

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

Nix / NixOS

nix run github:textfuel/lazyjira

Or add to your flake inputs:

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

deb (Debian, Ubuntu)

Download .deb from Releases:

sudo dpkg -i lazyjira_*.deb

rpm (Fedora, RHEL)

Download .rpm from Releases:

sudo rpm -i lazyjira_*.rpm

apk (Alpine)

Download .apk from Releases:

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

Download .zip from Releases, extract lazyjira.exe, and add it to your PATH.

Use Windows Terminal for best rendering.

Go / From source
go install github.com/textfuel/lazyjira/cmd/lazyjira@latest

Or build manually:

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

Setup

Run lazyjira. On first launch it asks for your Jira host, email, and API token.

Create an API token at https://id.atlassian.com/manage-profile/security/api-tokens

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.

Roadmap

  • Robust JQL search
  • Git integration - create branches from issues, open issue from current branch
  • Create issues
  • Rich text editing - colors, panels, media in ADF descriptions
  • Bulk operations - transition/assign multiple issues at once
  • Notifications - watch for issue updates
  • Offline mode - cached view when network is unavailable

Star History

Star History Chart

License

MIT

About

Lazygit but for Jira

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Contributors

Languages