Task Timer (tt) is a dead simple TUI task timer.

To get started, just run tt:

tt

You'll be presented with something like this:

You can just type a small description of what you're working on and press ENTER to start timing.

At any time, press ENTER again to stop the current timer or type a new task description and press ENTER to stop the previous task and start the new one.

Each task will have its own timer, and the sum of all tasks will be displayed in the header:

At any time, press CTRL+c to stop the current timer (if any) and exit.

You can also press ESC stop the current task and blur the input field and navigate around a long list of tasks using the arrow keys/page up/page down/etc.

Note: there is no concept of "resuming tasks", you can however create several tasks with the same description.

You can extract a markdown file by running:

tt report

It will output the given project (via -p PROJECT) to STDOUT. You can then save it to a file, pipe to another software or do whatever you like:

Let's say you forgot the timer running... you can edit it using the edit command:

tt edit

The project will be exporter to a JSON file and will open with your $EDITOR. Once you close it, it will be imported over the old one.

You can also backup/edit/restore using tt to-json and tt from-json.

At any time, check --help to see the available options.

homebrew:

brew install caarlos0/tap/tt

apt:

echo 'deb [trusted=yes] https://repo.caarlos0.dev/apt/ /' | sudo tee /etc/apt/sources.list.d/caarlos0.list
sudo apt update
sudo apt install tt

yum:

echo '[caarlos0]
name=caarlos0
baseurl=https://repo.caarlos0.dev/yum/
enabled=1
gpgcheck=0' | sudo tee /etc/yum.repos.d/caarlos0.repo
sudo yum install tt

arch linux:

yay -S tasktimer-bin

deb/rpm/apk:

Download the .apk, .deb or .rpm from the releases page and install with the appropriate commands.

manually:

Download the pre-compiled binaries from the releases page or clone the repo build from source.

Depends on the OS, but you can see yours running:

tt paths