A beautiful terminal-based time tracker built with Go and Bubble Tea. Track your work, manage projects, view reports, and run Pomodoro sessions — all without leaving the terminal.
- Timer — Start, stop, and pause time tracking with a single keypress
- Projects & Tasks — Organize entries by project and task with color-coded labels
- Dashboard — Live timer display, today's summary, and recent entries at a glance
- Reports — Daily and weekly bar charts with per-project breakdowns
- Pomodoro — Built-in Pomodoro timer with configurable work/break cycles
- Export — Export all entries to CSV or JSON
- Idle Detection — Auto-pause when idle, configurable timeout and action
- Settings — Customize Pomodoro durations, daily goal, idle behavior, and more
- Local Storage — All data stored in a local SQLite database, no account needed
- Zero Dependencies — Single binary, no CGO, cross-compilable
| Dashboard | Projects | Reports | Pomodoro | Settings |
|---|---|---|---|---|
go install github.com/sadopc/trackr@latestgit clone https://github.com/sadopc/trackr.git
cd trackr
go build -o trackr .
./trackr| Key | Action |
|---|---|
s |
Start timer |
x |
Stop timer |
space |
Pause / resume |
n |
New project / task |
d |
Archive project |
e |
Export (CSV / JSON) |
1–5 |
Switch tabs |
tab |
Next tab |
? |
Toggle help |
q |
Quit |
trackr stores data in a local SQLite database:
- macOS:
~/Library/Application Support/trackr/trackr.db - Linux:
~/.config/trackr/trackr.db
Exports are saved to your home directory as ~/trackr-export-{date}.csv or ~/trackr-export-{date}.json.
- Bubble Tea — TUI framework
- Lip Gloss — Styling and layout
- Bubbles — TUI components
- Huh — Terminal forms
- ntcharts — Terminal bar charts
- modernc.org/sqlite — Pure Go SQLite (no CGO)
go test ./... -count=1122 tests across store, TUI, and export packages.
MIT