Timewarrior is software that tracks time from the command line.
Timewarrior is a command line time tracking application, which allows you to record time spent on activities. You may be tracking your time for curiosity, or because your work requires it.
Timewarrior records time, and associates blocks of time with tags. The recorded data can be exposed as JSON for any app to consume.
Built-in reports, as well as a set of extension reports offer plenty of options, in addition to customizing your time reporting using any programming language. There will be a collection of reports and extensions to download and use.
A Taskwarrior hook script provides integration with the matching start and stop commands, thereby enabling proper time tracking for Taskwarrior users.
Key Features
- Simplest use of Timewarrior is as a stopwatch, to record an activity.
- Tags to label recorded time.
- Summary reports with configurable date ranges.
- Set of commands that allow you to make corrections, rectifying the common problem of forgetting to start or stop tracking at the right time, or using the wrong tags. Add tracked time in the past.
- Configurable.
- Uses color, and supports color themes. The colors are used for assorted highlighting, and for coloring tags on charts. Themes are optional.
- References holiday files and uses them when automatically filling in tracked time
- Simple charts in your terminal that show how your day is being tracked. They are intended to show a crude representation of the day.
- Supports hints, which are single-word command line features.
Website: timewarrior.net
Support: Documentation, Tutorial
Developer: Thomas Lauf, Paul Beckingham, Federico Hernandez
License: MIT License

Timewarrior is written in C++. Learn C++ with our recommended free books and free tutorials.
Related Software
| Terminal-Based Time Tracking | |
|---|---|
| doing | A CLI for a What Was I Doing system |
| Timewarrior | Records time and associates blocks of time with tags |
| Watson | Superb CLI to track your time |
| timetrap | Command line time tracker written in Ruby |
| timetrace | CLI to track working time supporting tags |
| arttime | Intriguing clock, timer, time manager with text art |
| tiempo | Stores entries as UTC |
| utt | Ultimate Time Tracker written in the Python programming language |
| Tock | Simple timetracker |
| Bartib | Simple timetracker |
| Timet | Time tracking gem with time reports |
| WorkTUImer | Keyboard-driven TUI for time-tracking |
| harsh | Habit tracking for geeks |
| arbtt | Automatic rule-base time tracker |
| Zeit | Track time spent on tasks and projects. |
| hours | No-frills time tracking |
| MyTimer | Geeky timer for terminal lovers |
| ctt | Time tracking for geeks |
| timr | TUI to organize your time |
| habitctl | Track and examine your habits |
| Tomat | Pomodoro timer |
| tmpo | Minimal CLI time tracker for developers |
| Productivity Timer | Pomodoro timer application for keyboard addicts and terminal fans |
| DevChron | TUI Pomodoro timer |
| Tmux Pomodoro Plus | Incorporate the Pomodoro technique |
| Y.A.c.H.T. | Habit tracker |
| timetracking | Simple utility to keep track of time |
| Timer-CLI | Very simple Python CLI tool to start a countdown timer |
| Taskmaster | Keep track of time worked and a simple todo list. |
| pomoru | Minimalist Pomodoro TUI |
| pom | Pomodoro timer |
| MatteriaTrack | Mystical Final Fantasy-themed CLI time tracker |
| fokus | Minimalist focus timer and stopwatch with daily logging |
| dijo | Scriptable, curses-based, digital habit tracker |
| Dayplan | Plan and track your time |
| cations | Build and maintain good habits through incremental progress |
Read our verdict in the software roundup.
Explore our comprehensive directory of recommended free and open source software. Our carefully curated collection spans every major software category.This directory is part of our ongoing series of informative articles for Linux enthusiasts. It features hundreds of detailed reviews, along with open source alternatives to proprietary solutions from major corporations such as Google, Microsoft, Apple, Adobe, IBM, Cisco, Oracle, and Autodesk. You’ll also find interesting projects to try, hardware coverage, free programming books and tutorials, and much more. Discovered a useful open source Linux program that we haven’t covered yet? Let us know by completing this form. |

