TL;DR — Quick Summary

Taskwarrior is a powerful CLI task manager. Add, filter, tag, annotate, and report on tasks with a flexible query language — GTD from your terminal.

Taskwarrior turns your terminal into a powerful task management system. Add, filter, tag, prioritize — with a query language that feels like SQL for your to-do list.

Installation

# macOS
brew install task

# Ubuntu/Debian
sudo apt install taskwarrior

# Arch Linux
sudo pacman -S task

Usage

# Add tasks
task add Buy groceries
task add Submit report due:friday project:work priority:H
task add Call dentist due:2026-04-01 +health +phone

# List tasks
task list                        # All pending
task                             # Default report
task next                        # Next actions

# Complete / delete
task 1 done                      # Complete task 1
task 1 delete                    # Delete task 1

# Modify tasks
task 1 modify priority:H
task 1 modify due:tomorrow
task 1 modify project:personal
task 1 modify +urgent

# Filter by project / tag / priority
task project:work
task +urgent
task priority:H
task due:today
task due.before:friday

# Annotations
task 1 annotate "Meeting moved to 3pm"

# Dependencies
task 2 modify depends:1          # Task 2 depends on task 1

# Recurring tasks
task add Review inbox recur:daily due:tomorrow
task add Weekly review recur:weekly due:monday

# Reports
task summary                     # Project summary
task burndown.daily              # Burndown chart
task history.monthly             # Monthly history
task calendar                    # Calendar view

# Undo
task undo

Summary

  • Taskwarrior is a powerful CLI task manager with projects, tags, priorities
  • Rich filter language for querying tasks by any attribute
  • Due dates, recurrence, dependencies, and annotations
  • Built-in reports: burndown, history, calendar, summary
  • Data stored locally in plain text — sync via Taskserver