Quick Start

1. Install the hook

In your git repository, run:

hourgit init

This installs a post-checkout git hook that silently records branch switches.

You can optionally assign the repo to a project:

hourgit init --project 'My Project'

2. Work normally

Time tracks automatically on every git checkout. Each branch switch creates a checkout entry that attributes time to the previous branch.

git checkout feature/auth
# ... work for 2 hours ...
git checkout fix/login-bug
# 2h attributed to feature/auth

3. Log non-git work

For meetings, reviews, research, or anything that isn't a branch switch:

hourgit log add --duration 1h30m "standup"
hourgit log add --from 9am --to 10:30am "code review"

4. View the interactive report

hourgit report

Navigate with arrow keys, press e to edit entries, a to add new ones. Checkout-derived time appears automatically (marked with *). When commits are synced, checkout sessions are split by commit — use Tab to cycle through entries in a cell and see commit messages in the detail panel.

Press s to submit the period — this persists all generated entries and marks the period as complete.

5. Export a PDF

hourgit report --export pdf

This generates a PDF timesheet with a day-by-day breakdown grouped by task.