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 tasks

    Select 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 or b5664ef8.

  • +TAG - Tagged tasks

    Select tasks with the given tag.

  • -TAG - Un-tagged tasks

    Select tasks that do not have the given tag.

  • status:pending, status:completed, status:deleted - Task status

    Select tasks with the given status.

  • all - All tasks

    When specified alone for task-modification commands, all matches all tasks. For example, task all done will mark all tasks as done.