task(1)
task is a command-line task management tool for organizing, tracking, and managing to-do items and projects.
Synopsis
task [OPTION]... [FILTER]... [COMMAND]...Description
Taskwarrior (task) is a flexible command-line task management system that helps users organize work, projects, and personal tasks with priorities, due dates, tags, and custom attributes. It stores tasks in a local database and provides powerful filtering, reporting, and project management capabilities.
Tasks can be organized with status (pending, completed, deleted), priorities, due dates, project assignments, tags, and custom metadata. The tool supports complex queries, recurring tasks, time tracking, and integration with other tools like calendar applications and time management systems.
Common options
| Flag | What it does |
|---|---|
add | Create a new task with the given description and attributes |
list | Display pending tasks in a table format (default view) |
done ID | Mark a task as completed by its ID number |
delete ID | Remove a task from the task list |
modify ID | Change attributes of an existing task |
+TAG | Add a tag to a task when adding or modifying |
due:DATE | Set or filter tasks by due date (e.g., due:tomorrow, due:2024-12-31) |
priority:H/M/L | Assign priority level: High, Medium, or Low |
project:NAME | Assign task to a project for organization |
report | Generate various summary reports of tasks and activity |
Examples
Add a high-priority task with a due date, assigned to the work project and tagged with 'work'
task add Write quarterly report due:2024-03-15 priority:H +workShow all pending tasks in the work project
task list project:work status:pendingMark task number 5 as completed
task 5 doneUpdate task 3's due date and lower its priority to medium
task 3 modify due:next Friday priority:MDisplay all tasks with the 'urgent' tag
task +urgentRemove task number 7 from the task list
task delete 7Show a summary report of tasks by project and status
task summaryMark multiple tasks (2, 3, and 5) as completed at once
task 2 3 5 done