Skip to content
~/patrick/projects/timetracker
← projects

tool

Time Tracker

A command line tool for tracking billable time from the terminal and turning it into invoices.

installuv tool install git+https://github.com/jpatrickb/timetrackerstack

PythonSQLiteTyperTextualTypst

links

source ↗

I built this to keep track of my own billable hours. You clock in and out from the terminal with tt in and tt out, or you can log an entry after the fact with a client, a project, and a description.

Clients and projects each have an hourly rate, and a project follows its client’s rate unless you give it its own. Reports can be filtered by client, project, and date, and grouped by entry, day, week, or month. They come out as a terminal table, Markdown, JSON, CSV, TSV, PDF, or Excel.

It also makes invoices as PDF or Excel files, with numbering for each client. Once an invoice is issued, its entries are locked so they can’t be changed by accident until the invoice is voided.

Everything is stored in one SQLite file, and times are kept in UTC so that daylight saving changes never alter a duration.

The hours and amounts in the recording above are example data.

nextjobtracker →

keyboard

⌘K /
Search and commands
t T
Next / previous theme
j k
Move through items on the page (k on the first one goes back to the top)
o
Open the selected item
g then h w p b a l
Home, Work, Projects, Blog, About, Lab
c
Copy email
?
This list

Choose a theme

Dark

Light

You can also press t to step through them.