tasktimer

README

tasktimer

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

---

Usage

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.

Report

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:

Edit

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.

My terminal is light

Gotcha you covered! TaskTimer automatically handles that thanks to the awesome lipgloss:

Help

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

Install

brew install caarlos0/tap/tt

Or use any of the other provided means in the releases page.

FAQ

Where are data and logs stored?

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

tt paths

Stargazers over time

Badges