page1
Dates
Exact specification
due:7/14/2008
NOTE: Determined by the <dateformat> configuration variable in the task configuration file.
Relative wording
due:today
due:yesterday
due:tomorrow
Day number with ordinal
due:23rd
End of week (Friday), month and year
due:eow
due:eom
due:eoy
Next occurring weekday
due:fri
Frequencies
daily, day, 1d, 2d, ...
Every day or a number of days.
weekdays
Mondays, Tuesdays, Wednesdays, Thursdays, Fridays and skipping weekend days.
weekly, 1w, 2w, ...
Every week or a number of weeks.
biweekly, fortnight
Every two weeks.
quarterly, 1q, 2q, ...
Every three months, a quarter, or a number of quarters.
semiannual
Every six months.
annual, yearly, 1y, 2y, ...
Every year or a number of years.
biannual, biyearly, 2y
Every two years.
Attribute Modifiers
before (under, below)
after (over, above)
none
any
is (equals)
isnt (not)
has (contain)
hasnt
startswith (left)
endswith (right)
word
noword
EDITING
add [tags] [attrs] description
Adds a new task to the task list.
log [tags] [attrs] description
Adds a new completed task to the task list.
append [tags] [attrs] description
Appends information to an existing task description.
prepend [tags] [attrs] description
Prepends information to an existing task description.
annotate ID description
Adds a time-stamped annotation to an existing task.
denotate ID description
Deletes an annotation from the specified task. A partial description will delete the first match.
duplicate ID [tags] [attrs] [description]
Duplicates the specified task and allows modifications.
start ID
Marks the specified task with a start time.
stop ID
Removes the start time from the specified task.
done ID [tags] [attrs] [description]
Marks the specified task as done.
Information
info ID
Shows all data and metadata for the specified task.
projects
Lists all project names that are currently used by pending tasks, and the number of tasks for each.
tags
Show a list of all tags used.
summary
Shows a report of task status by project.
timesheet [weeks]
Weekly report of tasks completed and started.
REPORTS & INFORMATION
active [tags] [attrs] [description]
Active tasks matching specified criteria that are incomplete.
all [tags] [attrs] [description]
All tasks matching the specified criteria.
completed [tags] [attrs] [description]
Completed tasks matching specified criteria.
minimal [tags] [attrs] [description]
Provides a minimal listing of tasks with specified criteria.
ls [tags] [attrs] [description]
Provides a short listing of tasks with specified criteria.
list [tags] [attrs] [description]
Provides a more detailed listing of tasks with specified criteria.
long [tags] [attrs] [description]
Provides the most detailed listing of tasks with specified criteria.
newest [tags] [attrs] [description]
Shows the newest tasks with specified criteria.
oldest [tags] [attrs] [description]
Shows the oldest tasks with specified criteria
ATTRIBUTES
+tag|-tag
Arbitrary words associated with a task. Use + to add a tag and – to remove a tag from a task.
project:<project-name>
Specifies the project to which a task is related to.
priority:H|M|L|N
Specifies High, Medium, Low and No priority for a task.
due:<due-date>
Specifies the due-date of a task.
recur:<frequency>
Specifies the frequency of a recurrence of a task.
until:<end-date-of-recurrence>
Specifies the Recurrence end-date of a task.
fg:<color-spec>
Specifies foreground color.
bg:<color-spec>
Specifies background color.
limit:<number-of-rows>
Specifies the desired number of tasks a report should show.
wait:<wait-date>
Date until task becomes pending.
undo
Reverts the task list to the most recent action.
delete ID
Deletes the specified task from the task list. Can be undone.
edit ID
Launches an editor to let you modify all aspects of a task directly. Use with care.
Modifying & Substitutions
ID [tags] [attrs] [description]
Modifies the existing task with provided information.
ID /from/to/
Performs one substitution on task description and annotation.
ID /from/to/g
Performs all substitutions on task description and annotation.
Escaping Special Characters
Quotes, escaping, or the double dash argument allow the use of special characters or commands within a description.
$ task add "quoted ' quote"
$ task add escaped \\' quote
$ task add -- project:Home needs scheduling
overdue [tags] [attrs] [description]
Shows all incomplete tasks matching the specified criteria
that are beyond their due date.
recurring [tags] [attrs] [description]
Shows all recurring tasks matching the specified criteria.
waiting [tags] [attrs] [description]
Shows all waiting tasks matching the specified criteria.
next [tags] [attrs] [description]
Shows all tasks with upcoming due dates matching the specified criteria.
history (history.monthly)
Report of task history by month.
history.annual
Report of task history by year.
ghistory (ghistory.monthly)
Graphical report of task status by month.
ghistory.annual
Graphical report of task status by year.
ID
Unique identifier for each task. ID sequences (1,4-10,19) can be given to commands to affect multiple tasks. Without a command, or arguments, displays the IDs "info.”
task [subcommand] [arguments]
task shell
Launches the Taskwarrior interactive shell.
TASKWARRIOR
Command Reference
taskwarrior.org
calendar [ y | due [y] | month year [y] | year ]
Shows a monthly calendar with due tasks marked.
stats
Shows task database statistics.
task was written by P. Beckingham
Copyright (C) 2006 \- 2010 P. Beckingham
distributed under the GNU General Public License.
<http://www.gnu.org/licenses/gpl-2.0.txt>