Slackwarrior Documentation

If this is your first time using Slackwarrior you should read our guide first. Below you'll find a list of all commands and fields you can use with your Tasks.

If you ever need some help, please join us on our Slack team or send an email to scheijan@slackwarrior.org.

Commands

Getting information about tasks

task	Get a list with some details of your three most urgent tasks, sorted by urgency in descending order.
task list	Get a complete list of all pending tasks, sorted by urgency in descending order.
task 23	Get all details on the task with the ID 23.

Adding tasks

task add DESCRIPTION

Add a task to your list with a given description.

The description is the only mandatory field. If not provided all fields but priority will be left empty. The field priority has a default value of LOW.

You can use all available fields when adding a task:

task add go back in time to deal with Sarah Conner project:skynet priority:H due:1997-08-29

For a complete list of options check fields.

Modifying tasks

task ID done	Complete the task with the given ID.
task ID start	Start tracking time for the task with the given ID.
task ID stop	Stop tracking time for the task with the given ID.
task ID annotate TEXT	Add an annotation with the given TEXT to the task with the given ID.
task ID modify [FIELD:VALUE] +NEWTAG -OLDTAG	Modify the task with the given ID. You can change all existing fields and add/remove tags with this command. For a complete list check fields.

Fields

Fieldname	Type	Description / Example
ID (readonly)	number	Short ID of the task.
UUID (readonly)	number	Unique ID of the task.
urgency (readonly)	number	Urgency is calculated by several factors. For details see the Taskwarrior documentation.
project	string	task add infiltrate resistance pro:skynet
priority	low, medium, high	task take over Cyberdyne priority:H
status	pending, waiting, completed, deleted	task 23 modify status:waiting
due	datetime	task add kill John Connor due:1995-06-08
start	datetime	task add optimize algorithm start:tomorrow
wait	datetime	task 23 modify wait:"next week"
scheduled	datetime	task 23 modify scheduled:yesterday

You can use shorthand forms for all field names and defined field values (priority, status), as long as they are distinct.

All datetime fields accept all date/time values that can be parsed by date.js.

For more detailed information on fields in Taskwarrior, please refer to the documentation.