Show HN: tmpo – Local-first CLI time tracker with automatic project detection

2 points

4 months ago

I got tired of manually logging billable hours in Google Forms, so I built tmpo – a CLI time tracker that lives in your terminal.

Quick workflow:

  cd my-project/
  tmpo start "Implementing auth"
  # ... work happens ...
  tmpo pause              # take a break
  tmpo resume             # back to work
  tmpo stop
  tmpo stats --week       # see your hours
  tmpo export --week      # CSV for invoicing

Key features:

- Automatically detects projects via git repos or .tmporc files

- Pure-Go SQLite storage (modernc.org/sqlite) - no CGO, easy cross-compilation

- Milestone tracking to organize work into sprints/phases

- Pause/resume for break tracking with full audit trail

- Local-first - all data stays on your machine

- Configurable date/time formats and timezone display

- CSV/JSON export for invoicing

Technical highlights:

- UTC timestamps in database with timezone conversion for display

- Migration system for schema evolution

- Currency handling for 30+ currency codes

- GoReleaser for automated cross-platform builds (macOS, Linux, Windows)

- Built with Cobra CLI framework

Started this because I needed something that worked with my git workflow and didn't require cloud accounts or subscriptions. Happy to answer questions about the architecture or design decisions.

MIT licensed: <https://github.com/DylanDevelops/tmpo>