Timewarrior is a command-line time tracking application that records how long you spend on different activities. It is suitable for tracking working hours, projects, personal tasks or simply discovering where your time goes during the day.
The application records time as intervals, each of which can be associated with one or more tags. You can start and stop tracking activities, record past intervals and correct mistakes when you forget to start or stop a timer. Existing intervals can be moved, resized, split, joined or extended to fill gaps in your records.
Timewarrior includes summary reports and terminal-based charts showing how your time is distributed across a day, week or month. Reports can be filtered by tags, dates and interval identifiers. Recorded data can also be exported and imported as JSON, making it possible to exchange information with other applications or transfer records between computers.
The application integrates with Taskwarrior through a hook script that automatically starts and stops time tracking alongside tasks. Timewarrior also supports custom reports and extensions for more specialised analysis.
This is free and open source software.
Key Features
- Track activities using simple start, stop and continue commands.
- Associate multiple tags with recorded intervals to organise activities and projects.
- Record past activities using explicit start and end times.
- Generate summary reports with configurable date ranges, tag filters and interval identifiers.
- Display colour-coded terminal charts showing tracked time by day, week or month.
- Correct recorded intervals by moving, lengthening, shortening, splitting, joining or deleting them.
- Fill gaps between recorded intervals using the fill command or the :fill hint.
- Add annotations to intervals and modify their associated tags.
- Import and export tracked intervals in JSON format.
- Supports configurable colour themes, work weeks, holiday files and command-line hints.
- Automatically track Taskwarrior activities using an on-modify hook script.
- Extend reporting capabilities through custom scripts and extensions.
Website: timewarrior.net
Support:
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 |
| klog | Track working hours and activities using plain-text logs |
| harsh | Habit tracking for geeks |
| arbtt | Automatic rule-base time tracker |
| 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.
LinuxLinks helps you discover the best free and open source software for Linux. Explore our extensive collection of recommended applications, including alternatives to popular proprietary software.We also publish software reviews, Linux tutorials, hardware reviews, free programming books and articles covering the wider open source community. Browse our Linux resources to discover more. Know a useful free and open source Linux application we haven't covered? Suggest a program for inclusion. Has your software been featured on LinuxLinks? Display one of our Featured on LinuxLinks badges on your website or GitHub README. |


Please read our Comment Policy before commenting.