Terminal time tracking
A fast, beautiful terminal UI for tracking time.
Track time entries, manage clients and projects, set billing rates, mark work as invoiced and paid, and generate income reports — all without leaving your terminal.
$ curl -fsSL https://raw.githubusercontent.com/aliasproject/notch/main/install.sh | sh
See features F
notch
Timers
Projects
Clients
Reports
| Task | Project | Duration | Status |
|---|---|---|---|
| Build feature | Acme Co › Website | 1:23:45 | |
| Fix bug #42 | Acme Co › Website | 0:45:10 | INVOICED |
| Client call | Globex › Retainer | 0:15:00 | PAID |
↑/k up ↓/j down n new e edit d delete space start/stop
1:23:45
Build feature
Features
Everything a freelancer or consultant needs to bill for their time.
Status bar integration
Your running timer, in your shell bar.
notch status prints the currently-running timer (or nothing, if idle) and exits — no daemon required. Works with waybar, tmux, i3blocks, dwm, or anything that shells out and reads stdout.
Build feature · 1:23:45
shell
1notch status # plain text — for shell bars
2notch status -json # JSON — for waybar
~/.config/waybar/config.jsonc
1"custom/notch": {
2 "exec": "notch status -json",
3 "return-type": "json",
4 "interval": 5
5}
Theming
Matches your terminal, not the other way around.
Drop a theme.conf in your config directory to recolor Notch. Changes are picked up live — no restart needed.
~/.config/notch/theme.conf
1primary = #91B0DE
2accent = #9DC6E9
3success = #99C2ED
4warning = #A4CBF7
5danger = #C79EA9
6bg = #0D171F