Skip to content

Repository files navigation

jiratui

GitHub Release CI Go Platform License

A minimal Jira Cloud TUI for active sprint tickets, task creation and editing with summary and description support, status changes, story points, and IONOS daily report drafts.

Installation

Go

Run without installing:

go run github.com/Ret2Hell/jiratui/cmd/jiratui@latest

Install globally:

go install github.com/Ret2Hell/jiratui/cmd/jiratui@latest

Arch Linux AUR

Install jiratui from the AUR:

yay -S jiratui-bin

Setup

Start the app to open setup when no config exists:

jiratui

Setup has two steps:

  1. Jira

  2. IONOS mail drafts

    • Mailbox email: full IONOS mailbox address
    • Mailbox password: mailbox password, not the IONOS control-panel password
    • Recipients: comma-separated report recipients

Setup keys: tab next, shift+tab previous, enter continue/save, q quit.

Secrets are stored in the OS keyring. You can also use:

JIRATUI_JIRA_TOKEN=...
JIRATUI_MAIL_PASSWORD=...

Config defaults to ~/.config/jiratui/config.yaml. Reopen setup with:

jiratui --setup

Keybindings

Press ? to open the contextual keybindings menu. Use / to select an action, / to filter, enter to run it, and esc to close.

Key Action
q quit
? open grouped keybindings
r refresh tickets
T choose application theme
/ filter tickets
tab switch panel focus
/ , j / k move selection or scroll focused panel
pgup / pgdown move one page
home / end, g / G jump to the beginning or end
Mouse wheel scroll the panel under the pointer
n create task
e / R edit selected task
D delete selected task after confirmation
enter set story points
u / c mark story points as unestimated while editing
t move to To Do
p / i move to In Progress
x / d move to Done
m open daily report draft
ctrl+s save task or report draft
ctrl+o paste a clipboard image into the focused task description
ctrl+r retry the selected Partial Save
A abandon the selected Partial Save while retaining accepted Jira changes
esc cancel/close

About

A minimal Jira Cloud TUI

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages