task

Add a new task

$ task add "[description]"

$ task add "[description]" project:[project_name] due:[tomorrow]

$ task list

$ task [task_id] done

$ task [task_id] modify priority:[H] due:[friday]

$ task [task_id] delete

$ task [task_id] info

$ task [task_id] start

task [globaloptions] [filter] command [arguments_]

Taskwarrior is a command-line task management application that maintains a list of tasks with support for projects, tags, priorities, due dates, and custom attributes. It provides powerful filtering and reporting capabilities.
Tasks can have attributes like project, priority (H/M/L), due dates, tags, wait dates, and user-defined attributes. Filters allow selecting tasks based on any combination of attributes. Reports provide customizable views of task data.
Configuration is stored in ~/.taskrc and task data in ~/.task/. These locations can be overridden via environment variables TASKRC and TASKDATA. All commands can be abbreviated as long as the prefix is unique.

add

Add a new task to the task list.

Mark a task as completed.

Delete a task from the list.

Modify attributes of an existing task.

Mark a task as started (active).

Mark a task as no longer active.

Add an annotation to a task.

Display pending tasks using the default report.

Show all data and metadata for a task.

Revert the most recent change.

Add a task that is already completed.

Create a copy of a task.

List all projects with task counts.

List all tags in use.

Use an alternative configuration file.

Suppress confirmation prompts.

Show more detailed output.

Suppress non-essential output.

Enable debugging output.

Display version information.

Task IDs are temporary and may change after sync or undo operations. For scripts and automation, use UUIDs instead. The undo command only reverts the most recent operation. Synchronization with a Taskserver requires additional setup.

Taskwarrior was created by Paul Beckingham and first released in 2006. It has grown from a simple todo list to a sophisticated task management system with sync capabilities, hooks, and extensive customization. The project is maintained by the Gothenburg Bit Factory and has inspired numerous frontends and integrations. Version 3.0, released in 2024, introduced significant architectural changes and improved performance.

taskrc(5), todo.txt-cli(1), remind(1), calcurse(1)