Hourgit

Time tracking that follows your git flow.

$ curl -fsSL https://hourgit.com/install.sh | bash

macOS · Linux · Free & open source

Windows →

How it works

1

Install in seconds

One command. No dependencies. No sudo.

$ curl -fsSL https://hourgit.com/install.sh | bash
info  Platform: darwin/arm64
info  Latest version: v0.8.3
info  Downloading hourgit-darwin-arm64-v0.8.3...
info  Checksum verified
info  Installed to ~/.hourgit/bin/hourgit
Hourgit v0.8.3 installed successfully!
2

Initialize your repo

Installs a git hook that silently tracks branch checkouts.

$ cd your-project
$ hourgit init --project 'Work'
Created project Work
Installed post-checkout hook
Repository assigned to Work
3

Just code

Every branch switch records a time commit. Working hours boundaries handle overnight gaps automatically.

$ git checkout feature/auth
# ⏳ tracking time on feature/auth

# ... 2 hours later ...

$ git checkout fix/login-bug
# ⏳ 2h attributed to feature/auth
# ⏳ now tracking fix/login-bug
4

Log non-code work

Meetings, reviews, research — log anything that isn't a branch switch.

$ hourgit log add --duration 1h30m "code review"
Logged 1h 30m — code review

$ hourgit log add --from 9am --to 10:30am "standup"
Logged 1h 30m — standup
5

View interactive reports

Navigate a tasks × days table with keyboard shortcuts. Edit, add, or remove time commits inline. Export to PDF.

$ hourgit report

┌─────────────────┬───────┬───────┬───────┬───────┬───────┬───────┐
│ TaskMonTueWedThuFriTotal │
├─────────────────┼───────┼───────┼───────┼───────┼───────┼───────┤
│ feature/auth    │ 3h*   │ 4h*   │ 2h*   │       │       │ 9h    │
│ fix/login-bug   │       │       │ 2h*   │ 5h*   │ 1h*   │ 8h    │
│ code review     │  30m  │       │  45m  │       │       │ 1h15m │
├─────────────────┼───────┼───────┼───────┼───────┼───────┼───────┤
│ Total           │ 3h30m │ 4h    │ 4h45m │ 5h    │ 1h    │ 18h15 │
└─────────────────┴───────┴───────┴───────┴───────┴───────┴───────┘
  ↑↓←→ navigate · e edit · a add · r remove · s submit · q quit
6

Submit when ready

Submitting persists all auto-generated time commits and marks the period as complete.

# Press 's' in the report view

  Submit February 2026?

  This will persist 12 generated entries
  and mark the period as submitted.

  ▸ Yes, submit
    Cancel

Free & Open Source

Free Forever

GPLv3 Licensed

100% free, forever. No paid tiers, no employee limits, no feature gates.

  • Unlimited projects
  • Unlimited entries
  • PDF export
  • All features included

Contribute

Help Make It Better

Hourgit is built in the open. Every contribution makes it better for everyone.

  • Report bugs
  • Submit PRs
  • Suggest features
  • Spread the word