Simple CLI to track your work hours. Written in Go with zero external dependencies and a local, CSV-based storage.

Most configuration is handled by the config.json.

In its most basic form, simply use the in and out commands to start and end your work day. Everything else is handled in the background by ttracker. The log of all working hours will be stored in a CSV file, named after the current year. An example file can be found in docs/2023_data.csv

# Starting a work day
./ttracker in <Optional start time (hh:mm)>

# Ending a work day
./ttracker out <Optional end time (hh:mm)>

The full list of supported commands is listed below.

• Golang (tested with >=1.18, but older versions should also work)

git clone https://github.com/FritzJo/ttracker.git
cd ttracker
go build *.go

# Or use the provided make file
# Build
make build

# Install
make install

# Uninstall
make uninstall

# Run code tests
make test

# Build binaries for all supported operating systems/architectures
make release

• Clock-in / Clock-out
• CSV based storage
• One file for each year
• Summary of hours worked overtime
• Taking time off
• Configuration of default work hours
• CSV validation
• Code quality and error handling
• Map time taken off to a specific day

• No

• The recommended way is to simply edit the csv with a text editor