taskwarrior is a free, open source project & work management project written in C++ and released under MIT. It has 6,071 GitHub stars, 422 forks and 436 open issues, and was last pushed 3 days ago. On this registry it ranks #14 of 62 tracked projects in Project & Work Management, with 5 head-to-head comparisons available. It gained 2 stars over the last 3 tracked days.

What is taskwarrior?

Taskwarrior is a portable, MIT-licensed command line task list management utility written in C++ for people who track to-dos and projects from a terminal instead of a graphical app.

What it is

Taskwarrior is an open source task list manager that runs in a terminal. It is developed by the GothenburgBitFactory organisation as a portable project, meaning the same utility is built and distributed for GNU/Linux and Unix systems, macOS, and Windows. The project's home is taskwarrior.org, which carries the online documentation, downloads, and news, and the code lives in the GothenburgBitFactory/taskwarrior repository under the MIT licence. It has collected 6,071 stars and 422 forks, and it is written in C++.

The problem it solves is the one faced by anyone who works inside a shell and does not want to leave it to track work. Instead of a graphical task manager that needs a desktop session, a window, and a pointer, Taskwarrior gives a command line task list that is installed from the same package repositories a user already trusts. Its topics list places it in the get things done (GTD) tradition and in the plain to-do list category. Rather than a fixed set of features, it is described as having a multitude of features and a vast ecosystem of tools, hooks, and extensions, so the workflow can be reshaped by the user instead of only by the vendor.

Key capabilities

  • Command line task list management, installed and invoked through the task package on Arch (extra/x86_64), Debian, Fedora, Ubuntu, and Homebrew.
  • Support for get things done (GTD) style workflows, reflected in the project's gtd topic.
  • An ecosystem of tools, hooks, and extensions documented at taskwarrior.org/tools, so behaviour can be extended without patching the core.
  • Portability across Linux/Unix, Mac OS, and Windows, with the current package versions tracked through Repology.
  • A documented source build path for contributors at doc/devel/contrib, for platforms without a ready package.
  • Online documentation at taskwarrior.org/docs and a download index at taskwarrior.org/download.
  • Community channels including GitHub Discussions, a Discord server, and the r/taskwarrior subreddit, with support options listed at taskwarrior.org/support.

Who uses it and how

  • Individual users on Linux/Unix, macOS, and Windows who keep personal to-do lists and projects in a terminal rather than a GUI app.
  • Practitioners of GTD methods, who are addressed directly by the project's topic list and by hooks and extensions that reshape the workflow.
  • Users of mainstream distributions who install the packaged task binary from Arch, Debian, Fedora, or Ubuntu repositories, or from Homebrew on macOS, rather than compiling it.
  • Contributors and integrators: the repository publishes a "good first issue" label, a contributing guide, a current milestone (milestone/26), and CI and coverage badges on the develop branch.
  • People seeking help through the discussions forum on GitHub, the Discord server, or the subreddit, which is the support route the README recommends before other options.

Getting started

Install the task package from the repository of the operating system in use — Arch, Debian, Fedora, or Ubuntu on Linux, or Homebrew on macOS — and consult taskwarrior.org/download for the full list of platforms. Where no package exists, Taskwarrior can be built from source following doc/devel/contrib.

How it compares

No list of paid products that Taskwarrior replaces is provided, and no comparable task managers are named in the facts. Within this registry it therefore stands alone, and any comparison must be drawn against tools the reader already knows rather than against anything listed here.

When to use it — and when not to

Taskwarrior has no database, mail service, or storage backend to operate, since it is a local command line utility rather than a server, so the cost of adopting it is a package install and a terminal habit. It is a poor fit for anyone who needs a graphical interface, a hosted web service, or a mobile-first experience, because none of those are offered here. Read the facts honestly: the README is mostly badges and pointers to taskwarrior.org, so real documentation sits off-repository, and 436 open issues indicate an active but busy tracker.

project readme (upstream, from github) — read inline


GitHub Actions build status Coverage Status Release Release date GitHub Sponsors

Taskwarrior

OS-X downloads Github downloads Linux downloads

Taskwarrior is a command line task list management utility with a multitude of features, developed as a portable open source project with an active and quite vast ecosystem of tools, hooks and extensions.

Install

Arch Debian Fedora Homebrew Ubuntu

Taskwarrior is packaged on a wide range of Linux/Unix systems, Mac OS and Windows. Check out the latest available packages in repositories of your OS distribution of choice on Repology.

Alternatively, you can build Taskwarrior from source.

Documentation

The online documentation, downloads, news and more are available on our website, taskwarrior.org.

Community

Discord Github discussions Reddit

Taskwarrior has a lively community on many places on the internet.

Best place to ask questions is our discussions forum on Github. For other support options, take a look at taskwarrior.org/support

For code contributions, please use pull requests. See Contributing to Taskwarrior for more details.

Contributing

Contributors Milestone progress Good first issus

Your contributions are especially welcome. Whether it comes in the form of code patches, ideas, discussion, bug reports, encouragement or criticism, your input is needed. See further development documentation in doc/devel.

Sponsoring

GitHub Sponsors

Taskwarrior is a result of work of mostly small group of volunteers, and has been in development since 2006.

If you are a happy Taskwarrior user, please consider sponsoring us through Github Sponsors.

Every sponsorship matters, as it directly increases the number of hours core developers can contribute to the project and makes the project more sustainable.

License

Taskwarrior is released under the MIT license. For details check the LICENSE file.

Frequently asked questions

Is taskwarrior free to use?

taskwarrior is open source under the MIT licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does taskwarrior do?

Taskwarrior - Command line Task Management

What is taskwarrior written in?

taskwarrior is primarily written in C++. Its source is publicly available at https://github.com/GothenburgBitFactory/taskwarrior, and it has 6,071 GitHub stars.