Download source tarball or access code repository here.


Latest stable release:

taskwarrior 2.6.2 (Released 2022-03-16): task-2.6.2.tar.gz
SHA3 92e547ac6bb88659e674877a19cb88dc9687be2ab989f0279b04f286

taskd server 1.1.0 (Released 2015-05-10): taskd-1.1.0.tar.gz
SHA1 ded339deeee65277e4712f71a9159502f8b20b52

Command reference taskwarrior 2.5.3: task-2.5.3.ref.pdf

See supported platforms for operating systems.

Quick Setup

Build the task program according to the directions in the INSTALL file. This transcript illustrates a typical installation:

$ ls
$ tar xzvf task-2.6.2.tar.gz
$ cd task-2.6.2
$ cmake -DCMAKE_BUILD_TYPE=release .
$ make
$ sudo make install

(Please note, that Cygwin is not supported anymore. Please use the Windows Subsystem for Linux to use Taskwarrior on Windows).

Ensure that the installed task program is in your PATH environment variable. On startup, task will check to see if it can find the configuration file and task directory, and if not found, will ask you whether it may create both.


Distribution Command Available since
Debian sid sudo apt-get install taskwarrior Debian sid
Debian sudo apt-get install taskwarrior 7.x Wheezy
Ubuntu sudo apt-get install taskwarrior 10.10 Maverick Meerkat
Fedora yum install task Fedora 18
Red Hat Enterprise Linux task has been submitted to the EPEL repositories of Fedora. Please refer to the EPEL documentation -
OpenSUSE zypper install taskwarrior openSUSE 12.2
Archlinux pacman -S task -
Slackware sbopkg -i task 13.0
Gentoo emerge task -
Sabayon sudo equo install task -
FreeBSD To install the port:
cd /usr/ports/deskutils/taskwarrior/
make install clean
To add the package:
pkg_add -r taskwarrior (Deprecated)
pkg install taskwarrior (Newer releases)
OpenBSD Before 5.8
sudo pkg_add -i taskwarrior
Version 5.8+
doas pkg_add -i taskwarrior
Mac OS X Homebrew: brew install task
Homebrew: brew install taskd
Homebrew: brew install tasksh
MacPorts: port install task
Cygwin Add it during setup Windows XP SP3
Windows 10 Bash on Ubuntu on Windows 10:
apt-get install task
Windows 10 Insider Preview
MSYS2 pacman -S task -
NixOS nix-env -i taskwarrior -
Void xbps-install task -

Git Repository

Get the whole source and history from our git repository. You will need git installed.


The master branch represents the latest stable release.

All other branches are development branches, and are works in progress and may not pass all quality tests, therefore may harm your data. While we welcome bug reports from the development branch, we do not guarantee proper or timely fixes.

  • Broken functionality may arise from ongoing development work
  • Make proper backups
  • Be aware that using the development branch involves risks
git clone

Example backup command:

$ tar czf ~/.task/task-backup-$(date +'%Y%m%d').tar.gz ~/.task/*

Older Versions

Please contact us if you wish to download prior versions.