Time tracking

Timewarrior – command-line time tracker

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.

Features include:

  • 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.

Return to CLI Time Trackers

Popular series
Free and Open Source SoftwareThe largest compilation of the best free and open source software in the universe. Each article is supplied with a legendary ratings chart helping you to make informed decisions.
ReviewsHundreds of in-depth reviews offering our unbiased and expert opinion on software. We offer helpful and impartial information.
Alternatives to Proprietary SoftwareReplace proprietary software with open source alternatives: Google, Microsoft, Apple, Adobe, IBM, Autodesk, Oracle, Atlassian, Corel, Cisco, Intuit, and SAS.
GamesAwesome Free Linux Games Tools showcases a series of tools that making gaming on Linux a more pleasurable experience. This is a new series.
Artificial intelligence iconMachine Learning explores practical applications of machine learning and deep learning from a Linux perspective. We've written reviews of more than 40 self-hosted apps. All are free and open source.
Guide to LinuxNew to Linux? Read our Linux for Starters series. We start right at the basics and teach you everything you need to know to get started with Linux.
Alternatives to popular CLI tools showcases essential tools that are modern replacements for core Linux utilities.
System ToolsEssential Linux system tools focuses on small, indispensable utilities, useful for system administrators as well as regular users.
ProductivityLinux utilities to maximise your productivity. Small, indispensable tools, useful for anyone running a Linux machine.
AudioSurveys popular streaming services from a Linux perspective: Amazon Music Unlimited, Myuzi, Spotify, Deezer, Tidal.
Saving Money with LinuxSaving Money with Linux looks at how you can reduce your energy bills running Linux.
Home ComputersHome computers became commonplace in the 1980s. Emulate home computers including the Commodore 64, Amiga, Atari ST, ZX81, Amstrad CPC, and ZX Spectrum.
Now and ThenNow and Then examines how promising open source software fared over the years. It can be a bumpy ride.
Linux at HomeLinux at Home looks at a range of home activities where Linux can play its part, making the most of our time at home, keeping active and engaged.
Linux CandyLinux Candy reveals the lighter side of Linux. Have some fun and escape from the daily drudgery.
DockerGetting Started with Docker helps you master Docker, a set of platform as a service products that delivers software in packages called containers.
Android AppsBest Free Android Apps. We showcase free Android apps that are definitely worth downloading. There's a strict eligibility criteria for inclusion in this series.
Programming BooksThese best free books accelerate your learning of every programming language. Learn a new language today!
Programming TutorialsThese free tutorials offer the perfect tonic to our free programming books series.
Linux Around The WorldLinux Around The World showcases usergroups that are relevant to Linux enthusiasts. Great ways to meet up with fellow enthusiasts.
Stars and StripesStars and Stripes is an occasional series looking at the impact of Linux in the USA.
Notify of

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Inline Feedbacks
View all comments