Filters
Filters are used to select specific tasks for reports or to specify tasks to be modified. When more than one filter is given, only tasks which match all of the filters are selected. When no filter is given, the command implicitly selects all tasks.
Filters can have the following forms:
-
TASKID[,TASKID,..]
- Specific tasksSelect only specific tasks. Multiple tasks can be specified either separated by commas or as separate arguments. Each task may be specfied by its working- set index (a small number) or by its UUID. Partial UUIDs, broken on a hyphen, are also supported, such as
b5664ef8-423d
orb5664ef8
. -
+TAG
- Tagged tasksSelect tasks with the given tag.
-
-TAG
- Un-tagged tasksSelect tasks that do not have the given tag.
-
status:pending, status:completed, status:deleted
- Task statusSelect tasks with the given status.
-
all
- All tasksWhen specified alone for task-modification commands,
all
matches all tasks. For example,task all done
will mark all tasks as done.