TaskWarrior How-to.md

TaskWarrior Quick Cheat Sheet

Last Update: 2017-01-11

Undelete a Task

task [id] modify end: status:pending

Undelete tasks that were deleted today

task +DELETED end:today modify end: status:pending

Default Values

task show default

Taskwarrior Default Command (Default Report)

task config default.command ready

Report Customization

Official Documentation: https://taskwarrior.org/docs/report.html

Display Report Configuration

• task show report
• task show report.ready
• task show report.next

Customize Report Filter

• task config report.ready.filter '+READY due.before:8d'

Taskwarrior Wait Date

https://taskwarrior.org/docs/using_dates.html#wait

Show Waiting Tasks

$ task waiting

Set Wait to 10 minutes

$ task 268 mod wait:10min

Set Wait to 3 days before due date:

$ task 268 mod wait:due-3d

Taskwarrior Reports

Reports by state

• task overdue
  • pending or waiting and overdue
• task active
  • has start date
• task next
  • is pending
• task ready
  • is pending, unblocked, unscheduled (or scheduled < now)

Reports by entry date

Pending or waiting tasks sorted by entry date.

• task newest
• task oldest

Reports with waiting tasks

• task waiting
• task minimal
• task overdue

Standard reports

Display pending tasks only.

• task ls
  • pending only
• task minimal
  • No due date
  • pending and waiting
• task long
  • show annotations
  • pending only