No description
Add support for selecting the current day in the Daily tab. Today's date is
now reachable via right/l/n, displayed with an amber "⚡ Today (in progress)"
badge, and the status bar shows a right-aligned "Last synced: HH:MM AM/PM"
timestamp sourced from the tickets table.
Pressing `r` (replacing ctrl+r) on today also clears the cached ticket_activity
rows before re-generating, forcing a fresh Jira fetch. On past days `r` only
regenerates the summary as before.
- db: add DeleteTicketActivityByProjectAndDate and GetLastSyncedForProjectAndDate
- tui/styles: add colorWarning (amber) and styleTodayBadge
- tui/browser: lift maxAllowedDate cap to today, today badge in date nav,
r key with today-aware activity cache busting, two-column status bar with
async last-synced timestamp
|
||
|---|---|---|
| cmd/jeera | ||
| internal | ||
| migrations | ||
| plans | ||
| prompts | ||
| research | ||
| .gitignore | ||
| AGENTS.md | ||
| APPLICATION.md | ||
| config.toml.example | ||
| go.mod | ||
| go.sum | ||
| jeera | ||
| JIRA.md | ||
| Makefile | ||
| README.md | ||
jeera
A terminal UI for browsing AI-generated Jira activity summaries — daily, weekly, monthly, and yearly — with a Year-in-Review feature.
Installation
go install git.packden.us/crueber/jeera/cmd/jeera@latest
Quick Start
- Copy the example config:
cp config.toml.example ~/.config/jeera/config.toml - Fill in your Jira and AI credentials in
~/.config/jeera/config.toml. - Run:
jeera
On first launch, if Jira credentials are missing, a setup wizard will guide you through configuration.
Configuration
Config is stored at $XDG_CONFIG_HOME/jeera/config.toml (defaults to ~/.config/jeera/config.toml).
| Field | Description |
|---|---|
jira.base_url |
Your Jira instance URL, e.g. https://mycompany.atlassian.net |
jira.email |
Your Jira account email |
jira.api_token |
Jira API token (generate at id.atlassian.com) |
ai.provider |
LLM provider: openai, openrouter, ollama, or lmstudio |
ai.base_url |
Override the provider's base URL (optional) |
ai.api_key |
API key for the LLM provider |
ai.model |
Model name to use (e.g. gpt-4o, llama3.2) |
The SQLite database is stored at $XDG_DATA_HOME/jeera/jeera.db (defaults to ~/.local/share/jeera/jeera.db).
Keybindings
Global
| Key | Action |
|---|---|
ctrl+a |
Open AI Settings |
ctrl+g |
Open Jira Settings |
ctrl+y |
Open Year-in-Review |
? |
Show help screen |
esc / q |
Go back / quit |
Browser
| Key | Action |
|---|---|
p |
Focus project input |
t |
Focus team input |
tab |
Cycle summary tabs (forward) |
shift+tab |
Cycle summary tabs (backward) |
h / ← |
Previous period |
l / → |
Next period |
n |
Jump to latest period |
j / ↓ |
Scroll down |
k / ↑ |
Scroll up |
PgDn |
Page down |
PgUp |
Page up |
ctrl+r |
Force refresh current view |
i |
Toggle Individual / Team mode |
Year-in-Review
| Key | Action |
|---|---|
r |
Regenerate year-in-review |
p |
Edit project key |
tab |
Cycle team tabs (forward) |
shift+tab |
Cycle team tabs (backward) |
j / k |
Scroll down / up |
Settings
| Key | Action |
|---|---|
ctrl+t |
Test connection |
ctrl+s |
Save settings |
Supported LLM Providers
| Provider | Default Base URL | Notes |
|---|---|---|
openai |
https://api.openai.com/v1 |
Requires api_key |
openrouter |
https://openrouter.ai/api/v1 |
Requires api_key |
ollama |
http://localhost:11434/v1 |
Local; no api_key needed |
lmstudio |
http://localhost:1234/v1 |
Local; no api_key needed |
Any OpenAI-compatible endpoint can be used by setting ai.base_url manually.
Mouse Support
Tab labels and date navigation arrows are clickable when running in a terminal that supports mouse input.