CheatPress

Taskwarrior Command-line to-do list

Version 3.4 · source

Taskwarrior, Postcard, light preview Light · Postcard 102 × 152 mm · PDF Taskwarrior, Postcard, dark preview Dark · Postcard 102 × 152 mm · PDF Taskwarrior, Postcard, ink saver preview Ink saver · Postcard 102 × 152 mm · PDF
Taskwarrior, A5, light preview Light · A5 148 × 210 mm · PDF Taskwarrior, A5, dark preview Dark · A5 148 × 210 mm · PDF Taskwarrior, A5, ink saver preview Ink saver · A5 148 × 210 mm · PDF
Taskwarrior, A4, light preview Light · A4 210 × 297 mm · PDF Taskwarrior, A4, dark preview Dark · A4 210 × 297 mm · PDF Taskwarrior, A4, ink saver preview Ink saver · A4 210 × 297 mm · PDF
Taskwarrior, A4 landscape, light preview Light · A4 landscape 297 × 210 mm · PDF Taskwarrior, A4 landscape, dark preview Dark · A4 landscape 297 × 210 mm · PDF Taskwarrior, A4 landscape, ink saver preview Ink saver · A4 landscape 297 × 210 mm · PDF
Taskwarrior, A3, light preview Light · A3 297 × 420 mm · PDF Taskwarrior, A3, dark preview Dark · A3 297 × 420 mm · PDF Taskwarrior, A3, ink saver preview Ink saver · A3 297 × 420 mm · PDF
Taskwarrior, A3 landscape, light preview Light · A3 landscape 420 × 297 mm · PDF Taskwarrior, A3 landscape, dark preview Dark · A3 landscape 420 × 297 mm · PDF Taskwarrior, A3 landscape, ink saver preview Ink saver · A3 landscape 420 × 297 mm · PDF
Taskwarrior, Letter, light preview Light · Letter 8.5 × 11 in · PDF Taskwarrior, Letter, dark preview Dark · Letter 8.5 × 11 in · PDF Taskwarrior, Letter, ink saver preview Ink saver · Letter 8.5 × 11 in · PDF
Taskwarrior, Tabloid, light preview Light · Tabloid 11 × 17 in · PDF Taskwarrior, Tabloid, dark preview Dark · Tabloid 11 × 17 in · PDF Taskwarrior, Tabloid, ink saver preview Ink saver · Tabloid 11 × 17 in · PDF

Start here

task add <description>
Create a task
task next
What to do now
task <id> done
Complete a task
task <id> modify <attrs>
Change a task
task <id> annotate <note>
Add a note
task project:<name> list
Filter a report
task undo
Revert last change
task sync
Sync with a server

Concepts

  1. pending new task
  2. active has start date
  3. completed history
  4. deleted kept in data

Add and change

task add <description>
Create a task
task add <desc> project:<p> +<tag> due:<date> priority:H
Add with attributes
task <id> modify <attrs>
Change attributes
task <id> done
Mark completed
task <id> delete
Delete a task
task <id> annotate <note>
Attach a note
task <id> denotate <text>
Remove a note
task <id> start
Mark as active
task <id> stop
Stop working on it
task <id> edit
Edit in $EDITOR
task <id> duplicate
Copy a task
task log <description>
Record an already-done task
task <id> prepend <text>
Add text before description
task <id> append <text>
Add text after description
task undo
Revert the last change
task <filter> modify project:
Clear an attribute
Assign an empty value to remove project, due, tags etc.

Reports

task next
Most urgent tasks
task list
All pending tasks
task <id> info
Full details of a task
task all
Every task, any status
task completed
Finished tasks
task waiting
Hidden until wait date
task overdue
Past their due date
task newest / oldest
Sorted by entry date
task projects
Projects with counts
task tags
Tags in use
task calendar
Months with due dates
task summary
Progress per project
task burndown.weekly
Burndown chart
task reports
List all report names
task count <filter>
Count matching tasks
task _get <id>.<attr>
Script-friendly attribute value
task <filter> export
JSON output

Filters

project:<name>
Tasks in a project
+<tag> / -<tag>
Has / lacks a tag
priority:H
By priority (H, M, L)
due:<date>
Due on a date
due.before:<date>
Due earlier than
due.after:<date>
Due later than
status:pending
By status
/<regex>/
Match description
description.has:<text>
Description contains
<f1> or <f2>
Combine with or / and / xor
Wrap groups in parentheses and quote them for the shell.
+OVERDUE
Virtual tag: past due
+TODAY / +WEEK
Virtual tags: due today / this week
+READY
Pending and not blocked
+BLOCKED / +BLOCKING
Dependency state
+ACTIVE
Started tasks
rc.<setting>=<value>
Override config for one run

Dates

due:tomorrow
Relative day name
due:eow
End of week
due:eom
End of month
due:friday
Next named weekday
due:2026-12-31
Absolute ISO date
due:now+3d
Offset by a duration
due:today+2w
Weeks from today
wait:<date>
Hide until a date
scheduled:<date>
When to start working
until:<date>
Auto-delete after a date
sow / eow / som / eom / soy / eoy
Start or end of week, month, year
1st / 2nd / 15th
Next day of month
3d / 2w / 1m / 1y
Duration units

Organise

task context define <name> <filter>
Save a filter as context
task context <name>
Activate a context
task context none
Deactivate context
task context list
Show defined contexts
task <id> modify depends:<id>
Block on another task
task <id> modify depends:
Remove dependencies
task add <desc> recur:weekly due:eow
Recurring task
task add <desc> recur:monthly until:<date>
Recurrence with end
task <id> modify priority:L
Set priority
task <id> modify +<tag> -<tag>
Add / remove tags
task <filter> modify project:<name>
Bulk move to a project
task project:<a>.<b>
Sub-project by dot name

Data and sync

task sync
Sync with the configured server
task config <key> <value>
Set a taskrc value
task show
Show effective configuration
task diagnostics
Version and environment info
task export > <file>
Back up as JSON
task import <file>
Import JSON tasks
task <id> modify uda:<value>
Set a user defined attribute
task version
Show version

Recipes

Daily triage
task +OVERDUE listtask +TODAY or +DUETODAY listtask next limit:5
Weekly project
task add 'Draft report' project:work.q4 due:eow +writingtask project:work.q4 listtask 12 starttask 12 done
Work-only view
task context define work project:work or +worktask context worktask nexttask context none
Rent reminder
task add 'Pay rent' recur:monthly due:1sttask all +CHILDtask 14 modify due:2nd