Skip to main content

Build an invoice with your tasks and hours worked from your commit messages

Project description

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

Read the docs for more details

Simple Usage

Set your hourly rate:

$ gitime set -r 50

Start a new invoice:

$ gitime invoice -n "Awesome Secret Project"

Time how long you’ve been working:

$ gitime timer start

Make a commit as you would normally, but on the commit step, use gitime instead of git:

$ git add feature.c
$ gitime commit -m "Added a really cool thing"
$ git push

Or, if you don’t like timers, record the time yourself with the –hours flag:

$ gitime commit -m "Proved Riemann Hypothesis" --hours 2

Look at your invoice:

$ gitime status
On invoice Awesome Secret Project
Total time worked: 3 hours
Total charges:     $150.00
07-21-2014         1 hour          Added a really cool thing
07-22-2014         2 hours         Proved Riemann Hypothesis

When it’s time to bill, export your invoice to a spreadsheet. Currently, the only format available is csv. More formats are coming soon:

$ gitime export


You’ll need two things installed to use gitime:

Install the latest release with:

$ pip install gitime --pre

Or install the development version with:

$ git clone
$ cd gitime
$ python install


The MIT License

Project details

Release history Release notifications

History Node


This version
History Node


History Node


History Node


History Node


History Node


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date (14.7 kB) Copy SHA256 hash SHA256 Source None Jul 23, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page