taskwarrior

Add a new task

$ task add [Buy groceries]

$ task list

$ task [1] done

$ task add [description] project:[Home] priority:[H]

$ task add [description] due:[tomorrow]

$ task add [description] +[work] +[urgent]

$ task [1] start

$ task [1] info

$ task [1] delete

task [filter] [command] [modifications]

Taskwarrior (task command) is a command-line TODO list manager. It provides flexible task management with support for projects, priorities, tags, due dates, recurrence, and dependencies.
Tasks can be filtered using any attribute, dates, or logical expressions. The tool generates various reports including lists, calendars, and burndown charts.
Configuration is stored in ~/.taskrc with extensive customization options. The tool supports hooks for automation and sync for sharing tasks across devices.

add description: Create a new task.
done: Mark task(s) as completed.
delete: Delete task(s).
start: Mark task(s) as started.
stop: Mark task(s) as stopped.
modify: Change task attributes.
annotate: Add note to task.
edit: Edit task in text editor.
list: Show pending tasks.
all: Show all tasks including completed.
next: Show most urgent tasks.
active: Show started tasks.
blocked: Show blocked tasks.
projects: List all projects.
tags: List all tags.
reports: List available reports.
shell: Interactive task shell.
config: Modify configuration.

project:name: Assign to project.
priority:H|M|L: Set priority (High/Medium/Low).
due:date: Set due date.
scheduled:date: Set scheduled date.
until:date: Set expiration date.
recur:freq: Set recurrence (daily, weekly, monthly).
wait:date: Hide until date.
+tag: Add tag.
-tag: Remove tag.
depends:id: Set task dependency.

First run creates ~/.taskrc configuration. Task IDs change as tasks are completed. Use UUID for permanent task references in scripts. Some reports require terminal width for proper display.

Taskwarrior was created by Paul Beckingham and Federico Hernandez. The first version was released in 2006, with the project growing into a comprehensive task management ecosystem including Taskserver for synchronization and Timewarrior for time tracking.

taskrc(5), taskd(1), timew(1), todo.txt-cli(1)