Skip to content

The Timewarrior Insider’s Guide

Everything we know about Timewarrior in one document: what it costs, its grades, getting a refund, getting help and what else to look at. Read it here, or keep a copy.

Download the PDF
Pass it onEmailLinkedInXWhatsApp
ToolGPANovember 2026

Timewarrior

The Insider’s Guide

Free, open-source time tracking from the command line

Every plan, grade, refund rule and rival among time tracking apps, read from Timewarrior’s own pages.

Made by Gothenburg Bit Factory · checked Nov 12, 2026 · toolgpa.com

2.6GPA

Contents

  1. 01WelcomeWhat it is, who it suits, its grades and the ten things to know first
  2. 02What it costsEvery plan, the free plan, ways to pay less and how prices have moved
  3. 03What it doesIts main features, where it runs, what it works with and who makes it
  4. 04Where it standsIts grades against its category, and whether to keep it or make your own
  5. 05The alternativesThe tools it is most often weighed against, side by side
  6. 06Quick answersThe questions people ask about it, each answered in a line or two
  7. 07About ToolGPAWho made this guide, what else is on the site, and how to cite it

ToolGPA put this guide together from Timewarrior’s own pages, its app-store listings and our grades. Every fact in it is on Timewarrior’s page too, where it is kept up to date. Checked Nov 12, 2026.

Part 01 · Overview

Welcome

What it is, who it suits, its grades and the ten things to know first

2.6

GPA, above 66 of the 98 other time tracking apps we grade

Timewarrior is a command-line time tracker. Intervals are started, stopped and tagged from the terminal, then corrected, summarized and exported with reports and charts. It is free and open source, and it can be linked to Taskwarrior through a hook.

To get you started, here are 8 things to know about Timewarrior, taken from its own pages and our grades.

There is no graphical interface and no Windows package, which will rule it out for most people.
From our report card of Timewarrior
  1. 1

    Best for tracking time from the command line

    Timewarrior is a free, open-source command-line stopwatch with tags, reports and export.

  2. 2

    It is free

    Timewarrior has no paid plan at all. Free and open source, with no paid plans.

  3. 3

    It runs on 2 platforms

    Linux and macOS.

  4. 4

    Simple stopwatch

    Start and stop tracking with single commands, or record backdated and already-closed intervals.

  5. 5

    Tags and annotations

    Label each interval with tags and notes, and change them later with tag, untag and retag commands.

  6. 6

    Corrections

    Commands to move, lengthen, shorten, split, join, fill and delete intervals, with an undo command.

  7. 7

    A 2.6 GPA, above 66 of 98

    That is against the other time tracking apps we grade, on value, the free plan, features, ease of use and platforms.

  8. 8

    Keep it

    Timewarrior is free, so making your own would save you nothing.

Timewarrior at a glance

Pricing
Free
Free plan
Yes
Free trial
None stated
Runs on
macOS, Linux
Made by
Gothenburg Bit Factory
Category
Time Tracking
Our grade
2.6 GPA, good

The report card

Best for tracking time from the command line

Timewarrior is a free, open-source command-line stopwatch with tags, reports and export. There is no graphical interface and no Windows package, which will rule it out for most people.

ToolGPA report cardTimewarriorGraded Nov 12, 2026
SubjectGradeComment
Value for moneyAFree, open source and downloadable, with no paid plans, against a time-tracking middle of $6.67 a month.
Free plan and trialAFree outright with no paid plans and no caps.
FeaturesCStopwatch, tags, annotations, corrections, reports and extensions; it does that job fully, but a smaller one, with no team or syncing features.
Ease of useDNo store rating on record, and it is a command-line tool you drive by typing commands.
Platforms and integrationsCLinux and Mac only, with no Windows package, phone apps or integrations on record.
Grade point averageGood, out of 4.02.6

An A is worth 4 points, a B 3, a C 2, a D 1 and an F nothing. The GPA is the average of the five.

Who Timewarrior is for

  • Fits if you live in the terminal and want a timer you can script
  • Works for developers who feed tracked time into their own tools

Who it is not for

  • Not for you if you want a window to click in, as there is no graphical interface
  • Skip it if you use Windows, as no Windows package is listed
  • Not for you if you need team or sync features, as none are described
  • Watch out: distribution packages are made by community maintainers, not the project

Good to know

Good for

  • Developers and others who work in a terminal
  • People who already use Taskwarrior
  • Anyone who wants free, open-source time tracking

Worth knowing

  • It is a command-line tool with no graphical interface.
  • The install page lists packages for Linux distributions and macOS only; no Windows package is listed.
  • Distribution packages are made by community maintainers, not the project.
  • There is no team or syncing feature described on the site.

Part 02 · Pricing

What it costs

Every plan, the free plan, ways to pay less and how prices have moved

Free

No paid plan at all

Timewarrior is free to use.

Free outright with no paid plans and no caps.
From our grade for free plan and trial
  • Free

    $0

    Free and open-source software, installed from distribution packages, Homebrew or built from source.

The free plan

Free and open source, with no paid plans.

Read from timewarrior.net on Nov 12, 2026.

Part 03 · Features

What it does

Its main features, where it runs, what it works with and who makes it

2

Places it runs: macOS and Linux

Free, open-source time tracking from the command line. Here is what it does, as its own site describes it, and what it covers: open source, time tracking, reports.

Linux and Mac only, with no Windows package, phone apps or integrations on record.
From our grade for platforms and integrations
Simple stopwatch
Start and stop tracking with single commands, or record backdated and already-closed intervals.
Tags and annotations
Label each interval with tags and notes, and change them later with tag, untag and retag commands.
Corrections
Commands to move, lengthen, shorten, split, join, fill and delete intervals, with an undo command.
Reports and export
Day, week, month and summary reports, plus an export command for use in other tools.
Extensions
An extension API lets scripts build custom reports, and a Taskwarrior on-modify hook ties tasks to tracked time.
Work week and holidays
Configuration for a work week, holidays and color themes.

Where it runs

  • macOS
  • Linux

What it works with

  • Taskwarrior

Timewarrior is made by Gothenburg Bit Factory.

Part 04 · Standing

Where it stands

Its grades against its category, and whether to keep it or make your own

66/98

Other time tracking apps it is graded above

Timewarrior's GPA of 2.6 is higher than 66 of the 98 other time tracking apps we grade, and level with 15.

It stands best on free plan and trial (A, above 91 of 98) and worst on ease of use (D, above 0).

Timewarrior has no paid plan.

On features, ease of use and platforms it scores 1.7 out of 4. Nothing scores higher for less, though at least one tool matches that score at a lower price.

Each grade against the category

Every bar is all 99 time tracking apps we grade, cut by the letter each got. Timewarrior’s own letter is outlined.

  • AValue for moneyAbove 86 of 98
  • AFree plan and trialAbove 91 of 98
  • CFeaturesAbove 0 of 98
  • DEase of useAbove 0 of 98
  • CPlatforms and integrationsAbove 5 of 98

Price against what you get

Each dot is one of 87 time tracking apps. Further left costs less; higher up scores better on features, ease of use and platforms. Timewarrior is the marked dot.

D1.0C2.0B3.0A4.0Free$1$2$5$10$20$50More for lessCosts more, scores moreCosts less, scores lessCosts more, scores lessTimewarriorClockifyFlowaceTeamdeckTimeScribeActivityWatch

What paid plans start at, a month (each step along is roughly double) →

Keep it, or make your own?

Whether this is something you could build for yourself with an AI app builder, and what you would give up.

Keep it

Timewarrior is free, so making your own would save you nothing.

It is one of the better ones too: its GPA of 2.6 is higher than 66 of the 98 other time tracking apps we grade.

What you could make

  • Time tracking and reports: an app builder makes these well.

What you could not

  • A real app for macOS and Linux. Something home-made would be a web page.

What this rests on. Timewarrior’s listing: what it does, where it runs, what it plugs into and what it costs. It is a judgement about the kind of software this is. We have not built a replacement for it, and making your own means looking after it too. How we decide, and every tool’s verdict.

Part 05 · Alternatives

The alternatives

The tools it is most often weighed against, side by side

ActivityWatch, Traggo, Kimai, TimeTagger and solidtime

The 5 tools Timewarrior is most often weighed against, with where each one differs from it.

  • 3.0GPA

    ActivityWatch

    Free

    Free, open-source automatic time tracker that keeps data local.

    • Only ActivityWatch lists Windows and Android apps.
    • Only ActivityWatch lists a browser extension.
    • Timewarrior also covers reports.
    Timewarrior and ActivityWatch compared in full
  • 2.0GPA

    Traggo

    Free

    Self-hosted, tag-based time tracking with dashboards.

    • Only Timewarrior lists Linux and macOS apps.
    • Only Traggo lists a web app.
    • Traggo is self-hostable, according to its own site.
    Timewarrior and Traggo compared in full
  • 2.4GPA

    Kimai

    Free plan · from €2.99/mo

    Open-source time tracking with invoicing, self-hosted or cloud.

    • Only Timewarrior lists Linux and macOS apps.
    • Only Kimai lists a web app.
    • Kimai is self-hostable, according to its own site.
    Timewarrior and Kimai compared in full
  • 2.6GPA

    TimeTagger

    Free plan · from €3/mo

    Open-source time tracker built on tags and a timeline.

    • Only Timewarrior lists Linux and macOS apps.
    • Only TimeTagger lists a web app.
    • TimeTagger is self-hostable, according to its own site.
    Timewarrior and TimeTagger compared in full
  • 2.6GPA

    solidtime

    Free plan · from €8/mo

    Open-source time tracker for freelancers and teams.

    • Only solidtime lists a web app.
    • Only solidtime lists a Windows app.
    • Only solidtime lists a browser extension.
    Timewarrior and solidtime compared in full

Part 06 · Questions

Quick answers

The questions people ask about it, each answered in a line or two

12

Questions, each answered in a line or two

The short version of everything above, for when you only need the answer. Each one is told in full in its part of the guide.

Is Timewarrior free?

Yes. Timewarrior is free to use.

How much does Timewarrior cost?

Timewarrior lists one plan. Free: $0.

What platforms does Timewarrior work on?

Timewarrior is available on Linux and macOS.

Does Timewarrior have an Android app?

No Android app was listed when its pages were read on Nov 12, 2026. Timewarrior is listed for Linux and macOS.

Does Timewarrior have an iPhone app?

No iPhone app was listed when its pages were read on Nov 12, 2026. Timewarrior is listed for Linux and macOS.

Is Timewarrior open source?

Yes. Timewarrior is open source, according to its own site.

What does Timewarrior integrate with?

Timewarrior's listing names Taskwarrior. A listing names up to eight integrations, so it may connect to more.

Who makes Timewarrior?

Timewarrior is made by Gothenburg Bit Factory.

What are the alternatives to Timewarrior?

The closest alternatives to Timewarrior in our directory are ActivityWatch, Traggo, Kimai, TimeTagger and solidtime.

How does Timewarrior compare with other time tracking apps?

Timewarrior's GPA of 2.6 is higher than 66 of the 98 other time tracking apps we grade, and level with 15.

Is Timewarrior good value for money?

ToolGPA grades Timewarrior A for value for money. Timewarrior has no paid plan.

Could I make my own version of Timewarrior?

Timewarrior is free, so making your own would save you nothing. It is one of the better ones too: its GPA of 2.6 is higher than 66 of the 98 other time tracking apps we grade.

Where this guide comes from

The prices, plans, platforms and features were read from Timewarrior’s own pages on Nov 12, 2026, and the grades were given on Nov 12, 2026. Graded from this listing, whose facts were read from Timewarrior's own pages on 12 November 2026. Not based on using the product, and shorter than our full reviews.

Every tool we list gets five grades, A to F, each with its reason, and a GPA that averages them. How each is decided is at toolgpa.com/grades. This guide is ToolGPA’s own work; it is not made, paid for or approved by Gothenburg Bit Factory. Prices change, so check timewarrior.net before you buy.

Part 07 · About

About ToolGPA

Who made this guide, what else is on the site, and how to cite it

7,721

Tools graded, in 95 categories

ToolGPA grades software the way a school report grades a pupil: five subjects, a letter for each with the reason written beside it, and a GPA that averages them. Prices, plans and platforms are read from each maker’s own pages and dated, so you always know how fresh a figure is.

Every grade, review and ranking on ToolGPA is our own judgement. No company can pay for a grade or change one. Every tool on the site has a guide like this one, free to download and pass on. It all lives at toolgpa.com.

  • 7,721

    tools graded

  • 95

    categories

  • 739

    price changes on record

  • 579

    apps priced in 12 countries

What else is on toolgpa.com

Scan for the live page

Prices and grades as they are today

Quoting this guide?

Please name ToolGPA and link to the live page, so readers can check the figures for themselves:

ToolGPA, "Timewarrior: The Insider's Guide", checked Nov 12, 2026. https://toolgpa.com/tools/timewarrior

Know someone choosing between time tracking apps?

Send them this guide: toolgpa.com/tools/timewarrior/guide

ToolGPA elsewhere: youtube.com/@toolgpa

See our other guides

The best-graded time tracking apps after Timewarrior, each with an Insider's Guide of its own.

ToolGPA

Choosing software? Every tool graded, every price dated.

Compare tools at toolgpa.com ›

Everything in this guide is ToolGPA’s own summary of what Timewarrior’s pages, its app-store listings and public reviews said on the dates shown. Grades are our judgement under the rules at toolgpa.com/grades. Every grade, review and ranking on ToolGPA is our own judgement. No company can pay for a grade or change one. Timewarrior is a trademark of its owner, and this guide is not made, paid for or approved by Gothenburg Bit Factory. Prices and plans change: check timewarrior.net before you buy.