taskwarrior

Taskwarrior

Inspect and manage tasks with task.

task +PENDING export

List Tasks

Preferred command (JSON output):

task +PENDING export

With custom filters:

task project:work due:today +PENDING export

For tasks that fall between two dates (entry, completion, due, or modified time), use Bash variables:

start_date="<start-date>"
end_date="<end-date>"
task "((entry.after:${start_date} and entry.before:${end_date}) or (end.after:${start_date} and end.before:${end_date}) or (due.after:${start_date} and due.before:${end_date}) or (modified.after:${start_date} and modified.before:${end_date}))" export

Use task rc.verbose=nothing ... for concise text output when not using export.

Task Summary

Build summary counts with these commands:

task +PENDING export
task +OVERDUE export
task due:today +PENDING export
task due:tomorrow +PENDING export
task priority:H +PENDING export

Summarize counts plus notable tasks (for example overdue or high priority).

Task Details

Get one task by ID or UUID:

task <task-id-or-uuid> export

Add Task

Create a task (mutating):

task add "Write Q1 planning notes" project:planning due:tomorrow priority:M +work +writing

Attach Notes

task-note is an external Taskwarrior helper, not a built-in task command. Confirm it is installed before using it:

command -v task-note

It takes exactly one argument. It ensures the task has a Notes file: <notes-dir>/<uuid>.md (read this file for full content) annotation, then opens the note in an interactive editor via taskopen:

task-note <task-id-or-uuid>

Notes live in $XDG_DATA_HOME/tasknotes/<uuid>.md (default ~/.local/share/tasknotes/<uuid>.md).

Non-interactive (agents)

task-note <task> with no subcommand opens an editor, so agents should use the subcommands instead:

task-note <task-id-or-uuid> set <<'EOF'
# Note title

Note body...
EOF

task-note <task-id-or-uuid> append <<'EOF'
More details...
EOF

task-note <task-id-or-uuid> show   # print the note contents
task-note <task-id-or-uuid> path   # print the note file path