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>