track

README

track

Track is a time tracking command line tool

Installation

Using Go:

go install github.com/mlange-42/track@latest

Without Go:

Download binaries for your OS from the Releases.

Features

• Track your working time from the command line
• Natural language-like syntax
• Supports hierarchical project structure
• Everything stored as YAML for human readibility
• Different types of text-based and graphical reports (in progress)

Usage

Get Help:

track -h
track <command> -h

First steps

Any time tracking track is associated to a Project. Before you can start tracking, create a project:

track create project MyProject

Now, start tracking time on the project:

track start MyProject

To stop tracking, use:

track stop

Getting information

track provides several commands to display information.

status

The status status informs about the running project:

track status

Prints something like:

+------------------+-------+-------+-------+
|          project |  curr | today | break |
|        MyProject | 00:30 | 01:45 | 00:13 |
+------------------+-------+-------+-------+

list

The list commands lists projects or records.

track list projects

track list records today
track list records yesterday
track list records 2022-12-31

report

The report command generates several kinds of reports.

Subcommand projects shows statistics of time tracked per project:

track report projects

Subcommand timeline shows statistics of time tracked per day, week or month:

track report timeline days

References

• Heavily inspired by github.com/dominikbraun/timetrace