task [command...]

A command line todo manager

Arguments

NameDescription
commandSearch criteria that select tasks

Subcommands

NameDescription
activeShows all tasks matching the filter, that are started but not completed
allShows all tasks matching the filter, including parents of recurring tasks
blockedShows all tasks matching the filter, that are currently blocked by other tasks
blockingShows all tasks matching the filter, that block other tasks
burndown.dailyShows a graphical burndown chart, by day. Is affected by the context
burndown.weeklyShows a graphical burndown chart, by week. Note that 'burndown' is an alias to the 'burndown.weekly' report. Is affected by the context
burndown.monthlyShows a graphical burndown chart, by month. Is affected by the context
calendarShows a monthly calendar with due tasks marked
commandsShows all the supported commands, with some details of each
diagnosticsShows diagnostic information, of the kind needed when reporting a problem
logoDisplays the Taskwarrior logo
newsGuides the user through important release notes anytime a new version of Taskwarrior is installed
reportsLists all supported reports
completedShows all tasks matching the filter that are completed
countDisplay only a count of tasks matching the filter. Is affected by the context
exportExports all tasks in the JSON format matching the filter
ghistory.annualShows a graphical report of task status by year
ghistory.monthlyShows a graphical report of task status by month
ghistory.weeklyShows a graphical report of task status by week
ghistory.dailyShows a graphical report of task status by day
helpShows the long usage text
history.annualShows a report of task history by year
history.monthlyShows a report of task history by month
history.weeklyShows a report of task history by week
history.dailyShows a report of task history by day
idsApplies the filter then extracts only the task IDs and presents them as a space-separated list
uuidsApplies the filter on all tasks (even deleted and completed tasks) then extracts only the task UUIDs and presents them as a space-separated list
udasShows a list of UDAs that are defined, including their name, type, label, and allowed values
informationShows all data and metadata for the specified tasks
longProvides the most detailed listing of tasks matching the filter
lsProvides a short listing of tasks matching the filter
minimalProvides a minimal listing of tasks matching the filter
newestShows the newest tasks matching the filter
nextShows a page of the most urgent tasks, sorted by urgency, which is a calculated value
readyShows a page of the most urgent ready tasks, sorted by urgency with started tasks first
oldestShows the oldest tasks matching the filter
overdueShows all incomplete tasks matching the filter that are beyond their due date
projectsLists all project names that are current used by pending tasks, and the number of tasks for each
recurringShows all recurring tasks matching the filter
unblockedShows all tasks that are not currently blocked by other tasks, matching the filter
waitingShows all waiting tasks matching the filter
addAdds a new pending task to the task list
annotateAdds an annotation to an existing task
appendAppends description text to an existing task
delete,rmDeletes the specified task from the task list
denotateDeletes an annotation for the specified task
doneMarks the specified task as done
duplicateDuplicates the specified task and allows modifications
editLaunches a text editor to let you modify all aspects of a task directly
logAdds a new task that is already completed, to the task list
modifyModifies the existing task with provided information
prependPrepends description text to and existing task
purgePermanently removes the specified tasks from the data files
startMarks the specified tasks as started
stopRemoves the start time from the specified task
contextSets the currently active context
statsShows statistics of the tasks defined by the filter
summaryShows a report of aggregated task status by project
tagsShow a list of all tags used
timesheetShows a weekly report of tasks completed and started
undoReverts the most recent action
versionShows the Taskwarrior version number

Options

NameDescription
--versionThis is the only conventional command line argument that Taskwarrior supports, and is intended for add-on scripts to verify the version number of an installed Taskwarrior without invoking the mechanisms that create default files