Gitime lets you keep track of your billable hours along with your commits. Build an invoice with your tasks and hours worked from your commit messages.


Gitime can run on Linux, Windows, and Mac.

You’ll only need two things installed to use gitime:

  • Git, and an executable called git on your path
  • Python 2.7 (or Python 3.4)

Install the latest gitime release with:

$ pip install gitime

Or install the development version with:

$ git clone
$ cd gitime
$ pip install -r requirements.txt
$ python install

Getting Started

The first thing you should do is set your standard hourly rate, if you have one. You can manually set this for each invoice as well. To charge $50 per hour, run:

$ gitime set -r 50

By default, gitime will round your hours worked to the nearest quarter hour. This can be changed to say, the nearest half-hour with:

$ gitime set --round 0.5

Now, create your first invoice, named after whatever project you’re working on. -r and --round are available here too, if you want a custom rate for this project:

$ gitime invoice -n "Awesome Secret Project"

When you’re ready to work, start the timer:

$ gitime timer start

You can pause, reset, or check the timer by replacing start with pause, reset, and status respectively.

When you’re ready, make your commit as you would normally, but change the git to gitime on the commit step:

$ git add .
$ gitime commit -m "Fixed a couple things"
$ git push

Your time will be logged automatically, and the commit will be made. When you’re ready for the next task, run gitime timer start again and repeat the process.

If you don’t want to use the timer and would rather keep track of the time yourself, run your commit with the --hours flag:

$ gitime commit -m "Fixed a couple things" --hours 3

If you don’t want to actually want to make a commit but want to log a task, run the commit with the --fake flag. Git will not be called.

You can check on your progress with:

$ gitime status

Or export your invoice to csv or xlsx with:

$ gitime export -f xlsx