jiratui

jiratui

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

   • Base URL: your Jira site, e.g. https://company.atlassian.net
   • Email: your Atlassian/Jira login email
   • API token: create one at https://id.atlassian.com/manage-profile/security/api-tokens
   • Project key: the prefix in issue IDs, e.g. OPS from OPS-123

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.