table of contents
- NAME
- DESCRIPTION
- BASIC USAGE
- PROJECTS
- PRIORITIES
- TAGS
- MODIFICATIONS
- INFO
- ANNOTATIONS
- CONFIGURATION
- DEFAULTS
- ALIASES
- COLOR
- ACTIVE TASKS
- DUE DATES
- CALENDAR
- RECURRENCE
- SHELL
- SPECIAL TAGS
- WAITING
- DEPENDENCIES
- REPORTS
- CUSTOM REPORTS
- CHARTS
- ADVANCED FILTERS
- HELP
- CREDITS & COPYRIGHTS
- SEE ALSO
- REPORTING BUGS
other versions
- wheezy 2.0.0-1
- wheezy-backports 2.2.0-3~bpo70+1
- jessie 2.3.0+dfsg-3
task-tutorial(5) | User Manuals | task-tutorial(5) |
NAME¶
task-tutorial - A tutorial for the task(1) command line todo manager.DESCRIPTION¶
This tutorial contains a narrative and a series of commands that lead you through different scenarios and illustrate the capabilities of taskwarrior. We will begin with basic usage, and progress to the more powerful features. It is recommended that you work through these examples alongside this tutorial.BASIC USAGE¶
Let's get started. We're planning a party, and there is a lot of work to do, so let's capture these tasks, by using the 'add' command.$ task add Select a free weekend in November
Created task 1.
$ task add Select and book a venue
Created task 2.
$ task add Come up with a guest list
Created task 3.
$ task add Mail invitations
Created task 4.
$ task add Select a caterer
Created task 5.
$ task list
ID Project Pri Due Active Age Description
-- ------- --- --- ------ ------- ---------------------------------
1 1 min Select a free weekend in November
2 55 secs Select and book a venue
3 49 secs Come up with a guest list
4 40 secs Mail invitations
5 33 secs Select a caterer
5 tasks
1 1 min Select a free weekend in November
2 55 secs Select and book a venue
3 49 secs Come up with a guest list
4 40 secs Mail invitations
5 33 secs Select a caterer
$ task log Order a special cake
Logged task.
$ task 4 duplicate /Mail/Design/
Duplicated 4 'Mail invitations'.
Duplicated 1 task.
Created task 7.
$ task 4 dup /Mail/Print/
Duplicated 4 'Mail invitations'.
Duplicated 1 task.
Created task 8.
$ task list
$ task 3 done
Completed 3 'Come up with a guest list'.
Marked 1 task as done.
$ task list
ID Project Pri Due Active Age Description
-- ------- --- --- ------ ------ ---------------------------------
1 8 mins Select a free weekend in November
2 7 mins Select and book a venue
3 6 mins Mail invitations
4 6 mins Select a caterer
5 4 mins Design invitations
6 4 mins Print invitations
6 tasks
1 8 mins Select a free weekend in November
2 7 mins Select and book a venue
3 6 mins Mail invitations
4 6 mins Select a caterer
5 4 mins Design invitations
6 4 mins Print invitations
PROJECTS¶
Remember to pay the rent at the end of the month.$ task add Pay teh rent on teh 31st
Created task 7.
$ task 7 modify /teh/the/g
Modified 1 task.
$ task list
ID Project Pri Due Active Age Description
-- ------- --- --- ------ ------- ---------------------------------
1 12 mins Select a free weekend in November
2 12 mins Select and book a venue
3 11 mins Mail invitations
4 11 mins Select a caterer
5 9 mins Design invitations
6 9 mins Print invitations
7 37 secs Pay the rent on the 31st
7 tasks
1 12 mins Select a free weekend in November
2 12 mins Select and book a venue
3 11 mins Mail invitations
4 11 mins Select a caterer
5 9 mins Design invitations
6 9 mins Print invitations
7 37 secs Pay the rent on the 31st
$ task 7 modify project:home
The scope of project 'home' has changed. Project 'home' is 0% complete (1 of 1
tasks remaining).
Modified 1 task.
$ task 1-6 modify project:party
Task 1 modify "Select a free weekend in November"
- project will be set to 'party'.
Proceed with change? (Yes/no/All/quit) A
The scope of project 'party' has changed. Project 'party' is 0% complete (1 of 1
tasks remaining).
The scope of project 'party' has changed. Project 'party' is 0% complete (2 of 2
tasks remaining).
The scope of project 'party' has changed. Project 'party' is 0% complete (3 of 3
tasks remaining).
The scope of project 'party' has changed. Project 'party' is 0% complete (4 of 4
tasks remaining).
The scope of project 'party' has changed. Project 'party' is 0% complete (5 of 5
tasks remaining).
The scope of project 'party' has changed. Project 'party' is 0% complete (6 of 6
tasks remaining).
Modified 6 tasks.
- project will be set to 'party'.
$ task projects
Project Tasks Pri:None Pri:L Pri:M Pri:H
------- ----- -------- ----- ----- -----
home 1 1 0 0 0
party 6 6 0 0 0
2 projects (7 tasks)
$ task project:home list
ID Project Pri Due Active Age Description
-- ------- --- --- ------ ------ ------------------------
7 home 5 mins Pay the rent on the 31st
1 task
$ task pro:par li
ID Project Pri Due Active Age Description
-- ------- --- --- ------ ------- ---------------------------------
1 party 18 mins Select a free weekend in November
2 party 17 mins Select and book a venue
3 party 17 mins Mail invitations
4 party 17 mins Select a caterer
5 party 15 mins Design invitations
6 party 15 mins Print invitations
6 tasks
7 home 5 mins Pay the rent on the 31st
1 party 18 mins Select a free weekend in November
2 party 17 mins Select and book a venue
3 party 17 mins Mail invitations
4 party 17 mins Select a caterer
5 party 15 mins Design invitations
6 party 15 mins Print invitations
PRIORITIES¶
Priorities are another way to organize tasks. You can use priority values of high, medium and low, and taskwarrior knows these as H, M or L.$ task 1-3,5 modify priority:H
Task 1 modify "Select a free weekend in November"
- priority will be set to 'H'.
Proceed with change? (Yes/no/All/quit) A
Modified 4 tasks.
$ task list
ID Project Pri Due Active Age Description
-- ------- --- --- ------ ------- ---------------------------------
1 party H 24 mins Select a free weekend in November
2 party H 23 mins Select and book a venue
3 party H 23 mins Mail invitations
5 party H 21 mins Design invitations
7 home 12 mins Pay the rent on the 31st
4 party 23 mins Select a caterer
6 party 21 mins Print invitations
7 tasks
- priority will be set to 'H'.
1 party H 24 mins Select a free weekend in November
2 party H 23 mins Select and book a venue
3 party H 23 mins Mail invitations
5 party H 21 mins Design invitations
7 home 12 mins Pay the rent on the 31st
4 party 23 mins Select a caterer
6 party 21 mins Print invitations
$ task 3 modify pri:
Modified 1 task.
TAGS¶
A task may only have one project, but it may have any number of tags, which are just single words associated with the task. I can go to the print shop at the mall, and do all the invitation tasks, so let's tag them all.$ task 3,5,6 modify +mall
Task 3 modify "Mail invitations"
- tags will be set to 'mall'.
Proceed with change? (Yes/no/All/quit) A
Modified 3 tasks.
- tags will be set to 'mall'.
$ task long
ID Project Pri Added Started Due Recur Countdown Age Deps Tags Description
-- ------- --- ---------- ------- --- ----- --------- ------- ---- ----
---------------------------------
1 party H 10/16/2010 27 mins Select a free weekend in November
2 party H 10/16/2010 26 mins Select and book a venue
5 party H 10/16/2010 23 mins mall Design invitations
7 home 10/16/2010 14 mins Pay the rent on the 31st
3 party 10/16/2010 25 mins mall Mail invitations
4 party 10/16/2010 25 mins Select a caterer
6 party 10/16/2010 23 mins mall Print invitations
7 tasks
1 party H 10/16/2010 27 mins Select a free weekend in November
2 party H 10/16/2010 26 mins Select and book a venue
5 party H 10/16/2010 23 mins mall Design invitations
7 home 10/16/2010 14 mins Pay the rent on the 31st
3 party 10/16/2010 25 mins mall Mail invitations
4 party 10/16/2010 25 mins Select a caterer
6 party 10/16/2010 23 mins mall Print invitations
$ task +mall list
ID Project Pri Due Active Age Description
-- ------- --- --- ------ ------- ------------------
5 party H 24 mins Design invitations
3 party 26 mins Mail invitations
6 party 24 mins Print invitations
3 tasks
5 party H 24 mins Design invitations
3 party 26 mins Mail invitations
6 party 24 mins Print invitations
$ task 3 modify -mall
Modified 1 task.
MODIFICATIONS¶
Task 7 is not worded correctly, so I can modify that by specifying a task ID and a new description. This is also considered a bulk change, and so requires confirmation.$ task 7 modify Pay rent at the end of the
month
Task 7 "Pay the rent on the 31st"
- description will be changed from 'Pay the rent on the 31st' to 'Pay rent at the end of the month'.
Proceed with change? (Yes/no/All/quit) Y
Modified 1 task.
- description will be changed from 'Pay the rent on the 31st' to 'Pay rent at the end of the month'.
$ task add music
$ task 8 prepend Select some
$ task 8 append for after dinner
$ task dinner list
ID Project Pri Due Active Age Description
-- ------- --- --- ------ ------- ----------------------------------
8 34 secs Select some Music for after dinner
1 task
8 34 secs Select some Music for after dinner
$ task 5 edit
[Your $EDITOR is invoked]
$ task add Hire a band?
$ task add Hire a band\?
$ task add "Hire a band?"
$ task add -- Hire a band\? +dj
Created task 9.
$ task undo
The last modification was made 10/16/2010
Prior Values Current Values
------------ ------------------------------------
description Hire a band? +dj
entry 10/16/2010
status pending
uuid 599c7598-069d-4598-8d94-0c919c4213ec
The undo command is not reversible. Are you sure you want to revert to the
previous state? (y/n) y
Task removed.
Prior Values Current Values
------------ ------------------------------------
$ task 1 delete
Permanently delete task 1 'Select a free weekend in November'? (y/n) y
Deleting task 1 'Select a free weekend in November'.
The scope of project 'party' has changed. Project 'party' is 0% complete (5 of 5
tasks remaining).
$ task undo
The last modification was made 10/16/2010
Prior Values Current Values
------------------------------------ ------------------------------------
description Select a free weekend in November Select a free weekend in November
entry 10/16/2010 10/16/2010
priority H H
project party party
status pending deleted
uuid 3a6881bb-628b-4f90-93d7-4da563b83d54 3a6881bb-628b-4f90-93d7-4da563b83d54
end 10/16/2010
The undo command is not reversible. Are you sure you want to revert to the
previous state? (y/n) y
Modified task reverted.
Prior Values Current Values
------------------------------------ ------------------------------------
INFO¶
During that undo operation, taskwarrior displayed metadata that is associated with the task. You can display this with the info command.$ task 1 info
Name Value
----------- ------------------------------------
ID 1
Description Select a free weekend in November
Status Pending
Project party
Priority H
UUID 3a6881bb-628b-4f90-93d7-4da563b83d54
Entered 10/16/2010 (44 mins)
There are also statistics that taskwarrior gathers, which I can display.
$ task stats
Category Data
-------------------- -------------
Pending 8
Waiting 0
Recurring 0
Completed 2
Deleted 0
Total 10
Annotations 0
Unique tags 1
Projects 2
Data size 9.3 KiB
Undo transactions 32
Tasks tagged 20%
Oldest task 10/16/2010
Newest task 10/16/2010
Task used for 29 mins
Task added every 2 mins
Task completed every 14 mins
Average time pending 31 mins
Average desc length 23 characters
ANNOTATIONS¶
Annotations are little notes that can be added to a task. There can be any number, and each has a time stamp.$ task 1 annotate the 13th looks good
Annotated 1 with 'the 13th looks good'.
$ task 1 annotate or the 14th
Annotated 1 with 'or the 14th'
$ task list
ID Project Pri Due Active Age Description
-- ------- --- --- ------ ------- ----------------------------------
1 party H 48 mins Select a free weekend in November
10/16/2010 the 13th looks good
10/16/2010 or the 14th
2 party H 47 mins Select and book a venue
5 party H 44 mins Design invitations
8 19 mins Select some Music for after dinner
7 home 35 mins Pay rent at the end of the month
3 party 47 mins Mail invitations
4 party 47 mins Select a caterer
6 party 44 mins Print invitations
8 tasks
1 party H 48 mins Select a free weekend in November
10/16/2010 the 13th looks good
10/16/2010 or the 14th
2 party H 47 mins Select and book a venue
5 party H 44 mins Design invitations
8 19 mins Select some Music for after dinner
7 home 35 mins Pay rent at the end of the month
3 party 47 mins Mail invitations
4 party 47 mins Select a caterer
6 party 44 mins Print invitations
$ task 1 denotate 14th
Found annotation 'or the 14th' and deleted it.
CONFIGURATION¶
There is a 'show' command, that is used to display the active configuration. There are hundreds of settings that can be changed, and every one has a sensible default.$ task show
Config variable Value
------------------------------- ----------------
_forcecolor no
active.indicator *
alias.export export.yaml
alias.export.vcalendar export.ical
alias.ghistory ghistory.monthly
alias.history history.monthly
alias.rm delete
...
weekstart Sunday
...
$ man taskrc
$ task config answer forty-two
Are you sure you want to add 'answer' with a value of 'forty-two'? (y/n) y
Config file .taskrc modified.
$ task show answer
Config variable Value
--------------- ---------
answer forty-two
Your .taskrc file contains these unrecognized variables:
answer
$ task config answer
Are you sure you want to remove 'answer'? (y/n) y
Config file .taskrc modified.
answer
$ task rc.report.list.sort=description+ list
ID Project Pri Due Active Age Description
-- ------- --- --- ------ ------- ----------------------------------
5 party H 51 mins Design invitations
3 party 53 mins Mail invitations
7 home 42 mins Pay rent at the end of the month
6 party 51 mins Print invitations
4 party 53 mins Select a caterer
1 party H 54 mins Select a free weekend in November
10/16/2010 the 13th looks good
2 party H 53 mins Select and book a venue
8 25 mins Select some Music for after dinner
8 tasks
Configuration override report.list.sort=description+
5 party H 51 mins Design invitations
3 party 53 mins Mail invitations
7 home 42 mins Pay rent at the end of the month
6 party 51 mins Print invitations
4 party 53 mins Select a caterer
1 party H 54 mins Select a free weekend in November
10/16/2010 the 13th looks good
2 party H 53 mins Select and book a venue
8 25 mins Select some Music for after dinner
DEFAULTS¶
There is a default command, which can be set to anything, in this case it is set to the 'list' report. Then running taskwarrior with no command name runs the default command.$ task config default.command list
Are you sure you want to add 'default.command' with a value of 'list'? (y/n) y
Config file .taskrc modified.
$ task
ID Project Pri Due Active Age Description
-- ------- --- --- ------ ------- ----------------------------------
1 party H 55 mins Select a free weekend in November
10/16/2010 the 13th looks good
2 party H 54 mins Select and book a venue
5 party H 52 mins Design invitations
8 26 mins Select some Music for after dinner
7 home 43 mins Pay rent at the end of the month
3 party 54 mins Mail invitations
4 party 54 mins Select a caterer
6 party 52 mins Print invitations
8 tasks
1 party H 55 mins Select a free weekend in November
10/16/2010 the 13th looks good
2 party H 54 mins Select and book a venue
5 party H 52 mins Design invitations
8 26 mins Select some Music for after dinner
7 home 43 mins Pay rent at the end of the month
3 party 54 mins Mail invitations
4 party 54 mins Select a caterer
6 party 52 mins Print invitations
$ task config default.priority H
Are you sure you want to add 'default.priority' with a value of 'H'? (y/n) y
Config file .taskrc modified.
$ task config default.project work
Are you sure you want to add 'default.project' with a value of 'work'? (y/n) y
Config file .taskrc modified.
$ task add New task
Created task 9.
$ task New task list
ID Project Pri Due Active Age Description
-- ------- --- --- ------ ------- -----------
9 work H 12 secs New task
1 task
9 work H 12 secs New task
$ task undo
The last modification was made 10/16/2010
Prior Values Current Values
------------ ------------------------------------
description New task
entry 10/16/2010
priority H
project work
status pending
uuid 0f44f9dd-79db-4098-b95b-4c3aa97d575a
The undo command is not reversible. Are you sure you want to revert to the
previous state? (y/n) y
Task removed.
$ task config default.priority
Are you sure you want to remove 'default.priority'? (y/n) y
Config file .taskrc modified.
$ task config default.project
Are you sure you want to remove 'default.project'? (y/n) y
Config file .taskrc modified.
Prior Values Current Values
------------ ------------------------------------
ALIASES¶
You can create aliases to effectively rename commands.$ task config alias.zzz list
Are you sure you want to add 'alias.zzz' with a value of 'list'? (y/n) y
Config file .taskrc modified.
$ task zzz
ID Project Pri Due Active Age Description
-- ------- --- --- ------ ------- ----------------------------------
1 party H 1 hr Select a free weekend in November
10/16/2010 the 13th looks good
2 party H 59 mins Select and book a venue
5 party H 56 mins Design invitations
8 30 mins Select some Music for after dinner
7 home 47 mins Pay rent at the end of the month
3 party 59 mins Mail invitations
4 party 58 mins Select a caterer
6 party 56 mins Print invitations
8 tasks
1 party H 1 hr Select a free weekend in November
10/16/2010 the 13th looks good
2 party H 59 mins Select and book a venue
5 party H 56 mins Design invitations
8 30 mins Select some Music for after dinner
7 home 47 mins Pay rent at the end of the month
3 party 59 mins Mail invitations
4 party 58 mins Select a caterer
6 party 56 mins Print invitations
$ task z
ID Project Pri Due Active Age Description
-- ------- --- --- ------ ------- ----------------------------------
1 party H 1 hr Select a free weekend in November
10/16/2010 the 13th looks good
2 party H 59 mins Select and book a venue
5 party H 56 mins Design invitations
8 30 mins Select some Music for after dinner
7 home 47 mins Pay rent at the end of the month
3 party 59 mins Mail invitations
4 party 58 mins Select a caterer
6 party 56 mins Print invitations
8 tasks
1 party H 1 hr Select a free weekend in November
10/16/2010 the 13th looks good
2 party H 59 mins Select and book a venue
5 party H 56 mins Design invitations
8 30 mins Select some Music for after dinner
7 home 47 mins Pay rent at the end of the month
3 party 59 mins Mail invitations
4 party 58 mins Select a caterer
6 party 56 mins Print invitations
COLOR¶
[Note that you will see color in your terminal as you work through this tutorial, but you will not see the color in the man page. This is a limitation of man pages in general. The text shown (without color) is included here.]$ task config color on
Are you sure you want to change the value of 'color' from 'off' to 'on'? (y/n) y
Config file .taskrc modified.
$ task list
ID Project Pri Due Active Age Description
-- ------- --- --- ------ ------- ----------------------------------
1 party H 1 hr Select a free weekend in November
10/16/2010 the 13th looks good
2 party H 1 hr Select and book a venue
5 party H 59 mins Design invitations
8 33 mins Select some Music for after dinner
7 home 50 mins Pay rent at the end of the month
3 party 1 hr Mail invitations
4 party 1 hr Select a caterer
6 party 59 mins Print invitations
8 tasks
1 party H 1 hr Select a free weekend in November
10/16/2010 the 13th looks good
2 party H 1 hr Select and book a venue
5 party H 59 mins Design invitations
8 33 mins Select some Music for after dinner
7 home 50 mins Pay rent at the end of the month
3 party 1 hr Mail invitations
4 party 1 hr Select a caterer
6 party 59 mins Print invitations
$ task color
Basic colors
black red blue green magenta cyan yellow white
black red blue green magenta cyan yellow white
Effects
red bold red underline on blue on green on bright green
color0 - color15
0 1 2 . . .
. . . 15
Color cube rgb000 - rgb555 (also color16 - color231)
0 1 2 3 4 5
0 1 2 3 4 5 0 1 2 3 4 5 0 1 2 3 4 5 0 1 2 3 4 5 0 1 2 3 4 5 0 1 2 3 4 5
0
1
2
3
4
5
Gray ramp gray0 - gray23 (also color232 - color255)
0 1 2 . . . . . . 23
Try running 'task color white on red'.
black red blue green magenta cyan yellow white
black red blue green magenta cyan yellow white
red bold red underline on blue on green on bright green
0 1 2 . . .
. . . 15
0 1 2 3 4 5
0 1 2 3 4 5 0 1 2 3 4 5 0 1 2 3 4 5 0 1 2 3 4 5 0 1 2 3 4 5 0 1 2 3 4 5
0
1
2
3
4
5
0 1 2 . . . . . . 23
$ task color white on red
Use this command to see how colors are displayed by your terminal.
16-color usage (supports underline, bold text, bright background):
task color black on bright yellow
task color underline cyan on bright blue
256-color usage (supports underline):
task color color214 on color202
task color rgb150 on rgb020
task color underline grey10 on grey3
task color red on color173
Your sample:
task color white on red
task color black on bright yellow
task color underline cyan on bright blue
task color color214 on color202
task color rgb150 on rgb020
task color underline grey10 on grey3
task color red on color173
task color white on red
$ task color legend
Here are the colors currently in use:
Color Definition
------------------------- -------------------------
color.active black on bright green
color.alternate
color.blocked black on white
color.calendar.due white on red
color.calendar.due.today bold white on red
color.calendar.holiday black on bright yellow
color.calendar.overdue black on bright red
color.calendar.today bold white on bright blue
color.calendar.weekend white on bright black
color.calendar.weeknumber bold blue
color.debug yellow
color.due red
color.due.today red
color.error yellow
color.footnote yellow
color.header yellow
color.history.add black on red
color.history.delete black on yellow
color.history.done black on green
color.overdue bold red
color.pri.H bold white
color.pri.L
color.pri.M white
color.pri.none
color.recurring magenta
color.summary.background on gray3
color.summary.bar on green
color.sync.added green
color.sync.changed yellow
color.sync.rejected red
color.tagged green
color.undo.after green
color.undo.before red
include
/usr/share/task/dark-blue-256.theme
include
/usr/share/task/dark-red-256.theme
include /usr/share/task/dark-256.theme
$ task "rc.color.project.party=on
rgb001" rc.color.keyword.invit=bold list
...
...
$ man task-color
ACTIVE TASKS¶
I'm selecting a venue, so let's indicate that task 2 is active by starting it. See how active tasks are affected by the color rules.$ task 2 start
Started 2 'Select and book a venue'.
$ task active
ID Project Pri Due Active Age Description
-- ------- --- --- ------ ---- -----------------------
2 party H * 1 hr Select and book a venue
1 task
$ task 2 stop
Stopped 2 'Select and book a venue'.
2 party H * 1 hr Select and book a venue
$ task config journal.time on
Are you sure you want to add 'journal.time' with a value of 'on'? (y/n) y
Config file .taskrc modified.
$ task config dateformat.annotation 'Y/m/d H:N'
Are you sure you want to add 'dateformat.annotation' with a value of 'Y/m/d
H:N'? (y/n) y
Config file .taskrc modified.
$ task 2 start
Started 2 'Select and book a venue'.
$ task venue list
ID Project Pri Due Active Age Description
-- ------- --- --- ------ ---- -----------------------------
2 party H * 1 hr Select and book a venue
2010/10/16 11:20 Started task
1 task
$ task 2 stop
Stopped 2 'Select and book a venue'.
$ task venue list
ID Project Pri Due Active Age Description
-- ------- --- --- ------ ---- -----------------------------
2 party H * 1 hr Select and book a venue
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
1 task
2 party H * 1 hr Select and book a venue
2010/10/16 11:20 Started task
2 party H * 1 hr Select and book a venue
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
DUE DATES¶
Due dates can be specified as dates, durations into the future or past, mnemonic, ordinal or day of week.$ task 1 modify due:7/31/2010
Modified 1 task.
$ task 1 modify due:2wks
Modified 1 task.
$ task 1 modify due:-2wks
Modified 1 task.
$ task 1 modify due:eom
Modified 1 task.
$ task 2 modify due:8th
Modified 1 task.
$ task 2 modify due:sunday
Modified 1 task.
$ task 5 modify due:eow
Modified 1 task.
$ task rc.dateformat.report:Y-M-DTH:N:SZ list
ID Project Pri Due Active Age Description
-- ------- --- -------------------- ------ ----
------------------------------------
2 party H 2010-10-17T00:00:00Z 1 hr Select and book a venue
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
5 party H 2010-10-22T00:00:00Z 1 hr Design invitations
1 party H 2010-10-31T00:00:00Z 1 hr Select a free weekend in November
2010/10/16 00:00 the 13th looks good
8 1 hr Select some Music for after dinner
7 home 1 hr Pay rent at the end of the month
3 party 1 hr Mail invitations
4 party 1 hr Select a caterer
6 party 1 hr Print invitations
8 tasks
Configuration override dateformat.report:Y-M-DTH:N:SZ
2 party H 2010-10-17T00:00:00Z 1 hr Select and book a venue
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
5 party H 2010-10-22T00:00:00Z 1 hr Design invitations
1 party H 2010-10-31T00:00:00Z 1 hr Select a free weekend in November
2010/10/16 00:00 the 13th looks good
8 1 hr Select some Music for after dinner
7 home 1 hr Pay rent at the end of the month
3 party 1 hr Mail invitations
4 party 1 hr Select a caterer
6 party 1 hr Print invitations
CALENDAR¶
When tasks have due dates, you can see them on the calendar.$ task calendar
include
/usr/share/task/holidays.en-US.rc
$ task calendar
October 2010 November 2010 December 2010
Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa
40 1 2 45 1 2 3 4 5 6 49 1 2 3 4
41 3 4 5 6 7 8 9 46 7 8 9 10 11 12 13 50 5 6 7 8 9 10 11
42 10 11 12 13 14 15 16 47 14 15 16 17 18 19 20 51 12 13 14 15 16 17 18
43 17 18 19 20 21 22 23 48 21 22 23 24 25 26 27 52 19 20 21 22 23 24 25
44 24 25 26 27 28 29 30 49 28 29 30 53 26 27 28 29 30 31
45 31
Legend: today, due, due-today, overdue, weekend, holiday, weeknumber.
October 2010 November 2010 December 2010
Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa
40 1 2 45 1 2 3 4 5 6 49 1 2 3 4
41 3 4 5 6 7 8 9 46 7 8 9 10 11 12 13 50 5 6 7 8 9 10 11
42 10 11 12 13 14 15 16 47 14 15 16 17 18 19 20 51 12 13 14 15 16 17 18
43 17 18 19 20 21 22 23 48 21 22 23 24 25 26 27 52 19 20 21 22 23 24 25
44 24 25 26 27 28 29 30 49 28 29 30 53 26 27 28 29 30 31
45 31
$ task cal 2010
January 2010 February 2010 March 2010 April 2010
Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa
1 1 2 6 1 2 3 4 5 6 10 1 2 3 4 5 6 14 1 2 3
2 3 4 5 6 7 8 9 7 7 8 9 10 11 12 13 11 7 8 9 10 11 12 13 15 4 5 6 7 8 9 10
3 10 11 12 13 14 15 16 8 14 15 16 17 18 19 20 12 14 15 16 17 18 19 20 16 11 12 13 14 15 16 17
4 17 18 19 20 21 22 23 9 21 22 23 24 25 26 27 13 21 22 23 24 25 26 27 17 18 19 20 21 22 23 24
5 24 25 26 27 28 29 30 10 28 14 28 29 30 31 18 25 26 27 28 29 30
6 31
May 2010 June 2010 July 2010 August 2010
Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa
18 1 23 1 2 3 4 5 27 1 2 3 32 1 2 3 4 5 6 7
19 2 3 4 5 6 7 8 24 6 7 8 9 10 11 12 28 4 5 6 7 8 9 10 33 8 9 10 11 12 13 14
20 9 10 11 12 13 14 15 25 13 14 15 16 17 18 19 29 11 12 13 14 15 16 17 34 15 16 17 18 19 20 21
21 16 17 18 19 20 21 22 26 20 21 22 23 24 25 26 30 18 19 20 21 22 23 24 35 22 23 24 25 26 27 28
22 23 24 25 26 27 28 29 27 27 28 29 30 31 25 26 27 28 29 30 31 36 29 30 31
23 30 31
September 2010 October 2010 November 2010 December 2010
Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa
36 1 2 3 4 40 1 2 45 1 2 3 4 5 6 49 1 2 3 4
37 5 6 7 8 9 10 11 41 3 4 5 6 7 8 9 46 7 8 9 10 11 12 13 50 5 6 7 8 9 10 11
38 12 13 14 15 16 17 18 42 10 11 12 13 14 15 16 47 14 15 16 17 18 19 20 51 12 13 14 15 16 17 18
39 19 20 21 22 23 24 25 43 17 18 19 20 21 22 23 48 21 22 23 24 25 26 27 52 19 20 21 22 23 24 25
40 26 27 28 29 30 44 24 25 26 27 28 29 30 49 28 29 30 53 26 27 28 29 30 31
45 31
Legend: today, due, due-today, overdue, weekend, holiday, weeknumber.
$ task rc.calendar.details:full cal
October 2010 November 2010 December 2010 January 2011
Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa
40 1 2 45 1 2 3 4 5 6 49 1 2 3 4 1 1
41 3 4 5 6 7 8 9 46 7 8 9 10 11 12 13 50 5 6 7 8 9 10 11 2 2 3 4 5 6 7 8
42 10 11 12 13 14 15 16 47 14 15 16 17 18 19 20 51 12 13 14 15 16 17 18 3 9 10 11 12 13 14 15
43 17 18 19 20 21 22 23 48 21 22 23 24 25 26 27 52 19 20 21 22 23 24 25 4 16 17 18 19 20 21 22
44 24 25 26 27 28 29 30 49 28 29 30 53 26 27 28 29 30 31 5 23 24 25 26 27 28 29
45 31 6 30 31
Legend: today, due, due-today, overdue, weekend, holiday, weeknumber.
ID Project Pri Due Active Age Description
-- ------- --- ---------- ------ ---- ------------------------------------
2 party H 10/17/2010 1 hr Select and book a venue
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
5 party H 10/22/2010 1 hr Design invitations
1 party H 10/31/2010 1 hr Select a free weekend in November
2010/10/16 00:00 the 13th looks good
3 tasks
Configuration override calendar.details:full
$ task rc.calendar.holidays:full cal
October 2010 November 2010 December 2010
Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa
40 1 2 45 1 2 3 4 5 6 49 1 2 3 4
41 3 4 5 6 7 8 9 46 7 8 9 10 11 12 13 50 5 6 7 8 9 10 11
42 10 11 12 13 14 15 16 47 14 15 16 17 18 19 20 51 12 13 14 15 16 17 18
43 17 18 19 20 21 22 23 48 21 22 23 24 25 26 27 52 19 20 21 22 23 24 25
44 24 25 26 27 28 29 30 49 28 29 30 53 26 27 28 29 30 31
45 31
Legend: today, due, due-today, overdue, weekend, holiday, weeknumber.
Date Holiday
---------- -----------------------------------
10/11/2010 Columbus Day
11/11/2010 Veterans Day
11/25/2010 Thanksgiving Day
12/25/2010 Christmas Day
12/31/2010 New Year's Eve
1/1/2011 New Year's Day
1/17/2011 Birthday of Martin Luther King, Jr.
2/21/2011 Washington's Birthday
Configuration override calendar.holidays:full
January 2010 February 2010 March 2010 April 2010
Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa
1 1 2 6 1 2 3 4 5 6 10 1 2 3 4 5 6 14 1 2 3
2 3 4 5 6 7 8 9 7 7 8 9 10 11 12 13 11 7 8 9 10 11 12 13 15 4 5 6 7 8 9 10
3 10 11 12 13 14 15 16 8 14 15 16 17 18 19 20 12 14 15 16 17 18 19 20 16 11 12 13 14 15 16 17
4 17 18 19 20 21 22 23 9 21 22 23 24 25 26 27 13 21 22 23 24 25 26 27 17 18 19 20 21 22 23 24
5 24 25 26 27 28 29 30 10 28 14 28 29 30 31 18 25 26 27 28 29 30
6 31
May 2010 June 2010 July 2010 August 2010
Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa
18 1 23 1 2 3 4 5 27 1 2 3 32 1 2 3 4 5 6 7
19 2 3 4 5 6 7 8 24 6 7 8 9 10 11 12 28 4 5 6 7 8 9 10 33 8 9 10 11 12 13 14
20 9 10 11 12 13 14 15 25 13 14 15 16 17 18 19 29 11 12 13 14 15 16 17 34 15 16 17 18 19 20 21
21 16 17 18 19 20 21 22 26 20 21 22 23 24 25 26 30 18 19 20 21 22 23 24 35 22 23 24 25 26 27 28
22 23 24 25 26 27 28 29 27 27 28 29 30 31 25 26 27 28 29 30 31 36 29 30 31
23 30 31
September 2010 October 2010 November 2010 December 2010
Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa
36 1 2 3 4 40 1 2 45 1 2 3 4 5 6 49 1 2 3 4
37 5 6 7 8 9 10 11 41 3 4 5 6 7 8 9 46 7 8 9 10 11 12 13 50 5 6 7 8 9 10 11
38 12 13 14 15 16 17 18 42 10 11 12 13 14 15 16 47 14 15 16 17 18 19 20 51 12 13 14 15 16 17 18
39 19 20 21 22 23 24 25 43 17 18 19 20 21 22 23 48 21 22 23 24 25 26 27 52 19 20 21 22 23 24 25
40 26 27 28 29 30 44 24 25 26 27 28 29 30 49 28 29 30 53 26 27 28 29 30 31
45 31
October 2010 November 2010 December 2010 January 2011
Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa
40 1 2 45 1 2 3 4 5 6 49 1 2 3 4 1 1
41 3 4 5 6 7 8 9 46 7 8 9 10 11 12 13 50 5 6 7 8 9 10 11 2 2 3 4 5 6 7 8
42 10 11 12 13 14 15 16 47 14 15 16 17 18 19 20 51 12 13 14 15 16 17 18 3 9 10 11 12 13 14 15
43 17 18 19 20 21 22 23 48 21 22 23 24 25 26 27 52 19 20 21 22 23 24 25 4 16 17 18 19 20 21 22
44 24 25 26 27 28 29 30 49 28 29 30 53 26 27 28 29 30 31 5 23 24 25 26 27 28 29
45 31 6 30 31
2 party H 10/17/2010 1 hr Select and book a venue
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
5 party H 10/22/2010 1 hr Design invitations
1 party H 10/31/2010 1 hr Select a free weekend in November
2010/10/16 00:00 the 13th looks good
October 2010 November 2010 December 2010
Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa
40 1 2 45 1 2 3 4 5 6 49 1 2 3 4
41 3 4 5 6 7 8 9 46 7 8 9 10 11 12 13 50 5 6 7 8 9 10 11
42 10 11 12 13 14 15 16 47 14 15 16 17 18 19 20 51 12 13 14 15 16 17 18
43 17 18 19 20 21 22 23 48 21 22 23 24 25 26 27 52 19 20 21 22 23 24 25
44 24 25 26 27 28 29 30 49 28 29 30 53 26 27 28 29 30 31
45 31
RECURRENCE¶
Remember the task we added to pay the rent? We're going to need to do that every month. Recurring tasks allow us to set up a single task that keeps coming back, just as you'd expect.$ task 7 modify due:eom recur:monthly
Task 7 is now a recurring task.
Modified 1 task.
$ task 7 info
Name Value
----------- ------------------------------------
ID 7
Description Pay rent at the end of the month
Status Recurring
Project home
Recurrence monthly
Mask
Due 10/31/2010
UUID f79123aa-3377-43fd-8f50-d14ab3c1577b
Entered 10/16/2010 (1 hr)
$ task 7 modify until:eoy
Modified 1 task.
$ task recurring
ID Project Pri Due Recur Active Age Description
-- ------- --- ---------- ------- ------ ---- --------------------------------
9 home 10/31/2010 monthly 1 hr Pay rent at the end of the month
1 task
9 home 10/31/2010 monthly 1 hr Pay rent at the end of the month
$ task add Pay taxes due:4/15/2007
recur:yearly
Created task 10.
$ task long
ID Project Pri Added Started Due Recur Countdown Age Deps Tags Description
-- ------- --- ---------- ------- ---------- ------- --------- ------ ---- ----
------------------------------------
11 10/16/2010 4/15/2007 yearly 3.5 yrs 2 secs Pay taxes
12 10/16/2010 4/15/2008 yearly 2.5 yrs 2 secs Pay taxes
13 10/16/2010 4/15/2009 yearly 1.5 yrs 2 secs Pay taxes
14 10/16/2010 4/15/2010 yearly 6 mths 2 secs Pay taxes
2 party H 10/16/2010 10/17/2010 -11 hrs 2 hrs Select and book a venue
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
5 party H 10/16/2010 10/22/2010 -5 days 2 hrs mall Design invitations
1 party H 10/16/2010 10/31/2010 -2 wks 2 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
9 home 10/16/2010 10/31/2010 monthly -2 wks 1 hr Pay rent at the end of the month
15 10/16/2010 4/15/2011 yearly -5 mths 2 secs Pay taxes
8 10/16/2010 1 hr Select some Music for after dinner
3 party 10/16/2010 2 hrs Mail invitations
4 party 10/16/2010 2 hrs Select a caterer
6 party 10/16/2010 2 hrs mall Print invitations
13 tasks
2 party H 10/16/2010 10/17/2010 -11 hrs 2 hrs Select and book a venue
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
5 party H 10/16/2010 10/22/2010 -5 days 2 hrs mall Design invitations
1 party H 10/16/2010 10/31/2010 -2 wks 2 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
9 home 10/16/2010 10/31/2010 monthly -2 wks 1 hr Pay rent at the end of the month
8 10/16/2010 1 hr Select some Music for after dinner
3 party 10/16/2010 2 hrs Mail invitations
4 party 10/16/2010 2 hrs Select a caterer
6 party 10/16/2010 2 hrs mall Print invitations
$ task 11 delete
Permanently delete task 11 'Pay taxes'? (y/n) y
This is a recurring task. Do you want to delete all pending recurrences of this
same task? (y/n) y
Deleting recurring task 10 'Pay taxes'.
Deleting recurring task 11 'Pay taxes'.
Deleting recurring task 12 'Pay taxes'.
Deleting recurring task 13 'Pay taxes'.
Deleting recurring task 14 'Pay taxes'.
Deleting recurring task 15 'Pay taxes'.
SHELL¶
You can use the shell command to create a more immersive environment. Any task command you run outside the shell can also be run inside the shell, without the need to prefix every command with "task".$ task shell
task 1.9.4 shell
Enter any task command (such as 'list'), or hit 'Enter'.
There is no need to include the 'task' command itself.
Enter 'quit' to end the session.
task>
task> projects
Project Tasks Pri:None Pri:L Pri:M Pri:H
------- ----- -------- ----- ----- -----
7 7 0 0 0
home 2 2 0 0 0
party 6 3 0 0 3
3 projects (15 tasks)
task> tags
Tag Count
mall 2
1 tag (15 tasks)
task> list
ID Project Pri Due Active Age Description
-- ------- --- ---------- ------ ----- ------------------------------------
2 party H 10/17/2010 2 hrs Select and book a venue
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
5 party H 10/22/2010 2 hrs Design invitations
1 party H 10/31/2010 2 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
9 home 10/31/2010 1 hr Pay rent at the end of the month
8 1 hr Select some Music for after dinner
3 party 2 hrs Mail invitations
4 party 2 hrs Select a caterer
6 party 2 hrs Print invitations
8 tasks
task> quit
7 7 0 0 0
2 party H 10/17/2010 2 hrs Select and book a venue
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
5 party H 10/22/2010 2 hrs Design invitations
1 party H 10/31/2010 2 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
9 home 10/31/2010 1 hr Pay rent at the end of the month
8 1 hr Select some Music for after dinner
3 party 2 hrs Mail invitations
4 party 2 hrs Select a caterer
6 party 2 hrs Print invitations
SPECIAL TAGS¶
You've seen tags, but there are also 'special tags' that have effects on individual tasks. The 'nocolor' special tag causes the color rules to be bypassed.$ task 6 modify +nocolor
Modified 1 task.
$ task tags
Tag Count
------- -----
mall 2
nocolor 1
2 tags (9 tasks)
$ task 6 modify -nocolor
Modified 1 task.
WAITING¶
When you have a task with a due date that is far out into the future, you may want to hide that task for a while.$ task add Look for new apartment due:eoy
Created task 10.
$ task 10 modify wait:12/1/2010
Modified 1 task.
$ task list
ID Project Pri Due Active Age Description
-- ------- --- ---------- ------ ----- ------------------------------------
2 party H 10/17/2010 2 hrs Select and book a venue
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
5 party H 10/22/2010 2 hrs Design invitations
1 party H 10/31/2010 2 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
9 home 10/31/2010 2 hrs Pay rent at the end of the month
8 1 hr Select some Music for after dinner
3 party 2 hrs Mail invitations
4 party 2 hrs Select a caterer
6 party 2 hrs Print invitations
8 tasks
$ task waiting
ID Project Pri Wait Age Description
-- ------- --- --------- ----- ----------------------
10 12/1/2010 1 min Look for new apartment
1 task
2 party H 10/17/2010 2 hrs Select and book a venue
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
5 party H 10/22/2010 2 hrs Design invitations
1 party H 10/31/2010 2 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
9 home 10/31/2010 2 hrs Pay rent at the end of the month
8 1 hr Select some Music for after dinner
3 party 2 hrs Mail invitations
4 party 2 hrs Select a caterer
6 party 2 hrs Print invitations
$ task add Do something in a few seconds
Created task 11.
$ task 11 modify wait:5s
Modified 1 task.
$ task list
ID Project Pri Due Active Age Description
-- ------- --- ---------- ------ ----- ------------------------------------
2 party H 10/17/2010 2 hrs Select and book a venue
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
5 party H 10/22/2010 2 hrs Design invitations
1 party H 10/31/2010 2 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
9 home 10/31/2010 2 hrs Pay rent at the end of the month
8 1 hr Select some Music for after dinner
3 party 2 hrs Mail invitations
4 party 2 hrs Select a caterer
6 party 2 hrs Print invitations
8 tasks
2 party H 10/17/2010 2 hrs Select and book a venue
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
5 party H 10/22/2010 2 hrs Design invitations
1 party H 10/31/2010 2 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
9 home 10/31/2010 2 hrs Pay rent at the end of the month
8 1 hr Select some Music for after dinner
3 party 2 hrs Mail invitations
4 party 2 hrs Select a caterer
6 party 2 hrs Print invitations
$ task list
ID Project Pri Due Active Age Description
-- ------- --- ---------- ------ ------- ------------------------------------
2 party H 10/17/2010 2 hrs Select and book a venue
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
5 party H 10/22/2010 2 hrs Design invitations
1 party H 10/31/2010 2 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
9 home 10/31/2010 2 hrs Pay rent at the end of the month
8 1 hr Select some Music for after dinner
11 18 secs Do something in a few seconds
3 party 2 hrs Mail invitations
4 party 2 hrs Select a caterer
6 party 2 hrs Print invitations
9 tasks
2 party H 10/17/2010 2 hrs Select and book a venue
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
5 party H 10/22/2010 2 hrs Design invitations
1 party H 10/31/2010 2 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
9 home 10/31/2010 2 hrs Pay rent at the end of the month
8 1 hr Select some Music for after dinner
3 party 2 hrs Mail invitations
4 party 2 hrs Select a caterer
6 party 2 hrs Print invitations
$ task 11 rc.confirmation:no delete
Deleting task 11 'Do something in a few seconds'.
DEPENDENCIES¶
Taskwarrior supports dependencies. Let's take a look at the party planning tasks, and assign dependencies.$ task pro:party list
ID Project Pri Due Active Age Description
-- ------- --- ---------- ------ ----- ------------------------------------
2 party H 10/17/2010 3 hrs Select and book a venue
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
5 party H 10/22/2010 3 hrs Design invitations
1 party H 10/31/2010 3 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
3 party 3 hrs Mail invitations
4 party 3 hrs Select a caterer
6 party 3 hrs Print invitations
6 tasks
2 party H 10/17/2010 3 hrs Select and book a venue
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
5 party H 10/22/2010 3 hrs Design invitations
1 party H 10/31/2010 3 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
3 party 3 hrs Mail invitations
4 party 3 hrs Select a caterer
6 party 3 hrs Print invitations
$ task 3 modify depends:6
Modified 1 task.
$ task 6 modify dep:5
Modified 1 task.
$ task 2 modify dep:1
Modified 1 task.
$ task 5 modify dep:1,2
Modified 1 task.
$ task 4 modify dep:1
Modified 1 task.
$ task pro:party long
ID Project Pri Added Started Due Recur Countdown Age Deps Tags Description
-- ------- --- ---------- ------- ---------- ----- --------- ----- ---- ----
------------------------------------
2 party H 10/16/2010 10/17/2010 -10 hrs 3 hrs 1 Select and book a venue
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
5 party H 10/16/2010 10/22/2010 -5 days 3 hrs 1,2 mall Design invitations
1 party H 10/16/2010 10/31/2010 -2 wks 3 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
3 party 10/16/2010 3 hrs 6 Mail invitations
4 party 10/16/2010 3 hrs 1 Select a caterer
6 party 10/16/2010 3 hrs 5 mall Print invitations
6 tasks
2 party H 10/16/2010 10/17/2010 -10 hrs 3 hrs 1 Select and book a venue
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
5 party H 10/16/2010 10/22/2010 -5 days 3 hrs 1,2 mall Design invitations
1 party H 10/16/2010 10/31/2010 -2 wks 3 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
3 party 10/16/2010 3 hrs 6 Mail invitations
4 party 10/16/2010 3 hrs 1 Select a caterer
6 party 10/16/2010 3 hrs 5 mall Print invitations
$ task 5 modify dep:-1
Modified 1 task.
$ task blocked
ID Deps Project Pri Due Active Age Description
-- ---- ------- --- ---------- ------ ----- -----------------------------
2 1 party H 10/17/2010 3 hrs Select and book a venue
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
5 2 party H 10/22/2010 3 hrs Design invitations
3 6 party 3 hrs Mail invitations
4 1 party 3 hrs Select a caterer
6 5 party 3 hrs Print invitations
5 tasks
$ task unblocked
ID Deps Project Pri Due Active Age Description
-- ---- ------- --- ---------- ------ ----- ------------------------------------
1 party H 10/31/2010 3 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
9 home 10/31/2010 3 hrs Pay rent at the end of the month
8 3 hrs Select some Music for after dinner
3 tasks
2 1 party H 10/17/2010 3 hrs Select and book a venue
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
5 2 party H 10/22/2010 3 hrs Design invitations
3 6 party 3 hrs Mail invitations
4 1 party 3 hrs Select a caterer
6 5 party 3 hrs Print invitations
1 party H 10/31/2010 3 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
9 home 10/31/2010 3 hrs Pay rent at the end of the month
8 3 hrs Select some Music for after dinner
$ task 1 info
Name Value
--------------------- ------------------------------------
ID 1
Description Select a free weekend in November
2010/10/16 00:00 the 13th looks good
Status Pending
Project party
Priority H
This task is blocking 2 Select and book a venue
4 Select a caterer
Due 10/31/2010
UUID 3a6881bb-628b-4f90-93d7-4da563b83d54
Entered 10/16/2010 (3 hrs)
2010/10/16 00:00 the 13th looks good
4 Select a caterer
$ task 2 info
Name Value
--------------------- ------------------------------------
ID 2
Description Select and book a venue
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
Status Pending
Project party
Priority H
This task blocked by 1 Select a free weekend in November
This task is blocking 5 Design invitations
Due 10/17/2010
UUID 773c2b02-919e-4527-95f0-814c19dd198a
Entered 10/16/2010 (3 hrs)
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
$ task 2 done
Task 2 is blocked by:
1 Select a free weekend in November
and is blocking:
5 Design invitations
Would you like the dependency chain fixed? (y/n) y
Completed 2 'Select and book a venue'.
Project 'party' is 12% complete (7 of 8 tasks remaining).
Marked 1 task as done.
$ task 1 info
Name Value
--------------------- ------------------------------------
ID 1
Description Select a free weekend in November
2010/10/16 00:00 the 13th looks good
Status Pending
Project party
Priority H
This task is blocking 4 Select a caterer
5 Design invitations
Due 10/31/2010
UUID 3a6881bb-628b-4f90-93d7-4da563b83d54
Entered 10/16/2010 (3 hrs)
1 Select a free weekend in November
5 Design invitations
2010/10/16 00:00 the 13th looks good
5 Design invitations
REPORTS¶
Taskwarrior has a good many reports. There is a report with minimal information:$ task minimal
ID Project Description
-- ------- ------------------------------------
7 Select some Music for after dinner
8 home Pay rent at the end of the month
4 party Design invitations
2 party Mail invitations
5 party Print invitations
3 party Select a caterer
1 party Select a free weekend in November
2010/10/16 00:00 the 13th looks good
7 Select some Music for after dinner
8 home Pay rent at the end of the month
4 party Design invitations
2 party Mail invitations
5 party Print invitations
3 party Select a caterer
1 party Select a free weekend in November
2010/10/16 00:00 the 13th looks good
$ task ls
ID Project Pri Description
-- ------- --- ------------------------------------
1 party H Select a free weekend in November
2010/10/16 00:00 the 13th looks good
4 party H Design invitations
7 Select some Music for after dinner
8 home Pay rent at the end of the month
2 party Mail invitations
3 party Select a caterer
5 party Print invitations
1 party H Select a free weekend in November
2010/10/16 00:00 the 13th looks good
4 party H Design invitations
7 Select some Music for after dinner
8 home Pay rent at the end of the month
2 party Mail invitations
3 party Select a caterer
5 party Print invitations
$ task list
ID Project Pri Due Active Age Description
-- ------- --- ---------- ------ ----- ------------------------------------
4 party H 10/22/2010 5 hrs Design invitations
1 party H 10/31/2010 6 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
8 home 10/31/2010 5 hrs Pay rent at the end of the month
7 5 hrs Select some Music for after dinner
2 party 5 hrs Mail invitations
3 party 5 hrs Select a caterer
5 party 5 hrs Print invitations
4 party H 10/22/2010 5 hrs Design invitations
1 party H 10/31/2010 6 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
8 home 10/31/2010 5 hrs Pay rent at the end of the month
7 5 hrs Select some Music for after dinner
2 party 5 hrs Mail invitations
3 party 5 hrs Select a caterer
5 party 5 hrs Print invitations
$ task long
ID Project Pri Added Started Due Recur Countdown Age Deps Tags Description
-- ------- --- ---------- ------- ---------- ------- --------- ----- ---- ----
------------------------------------
4 party H 10/16/2010 10/22/2010 -5 days 5 hrs 1 mall Design invitations
1 party H 10/16/2010 10/31/2010 -2 wks 6 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
8 home 10/16/2010 10/31/2010 monthly -2 wks 5 hrs Pay rent at the end of the month
7 10/16/2010 5 hrs Select some Music for after dinner
2 party 10/16/2010 5 hrs 5 Mail invitations
3 party 10/16/2010 5 hrs 1 Select a caterer
5 party 10/16/2010 5 hrs 4 mall Print invitations
4 party H 10/16/2010 10/22/2010 -5 days 5 hrs 1 mall Design invitations
1 party H 10/16/2010 10/31/2010 -2 wks 6 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
8 home 10/16/2010 10/31/2010 monthly -2 wks 5 hrs Pay rent at the end of the month
7 10/16/2010 5 hrs Select some Music for after dinner
2 party 10/16/2010 5 hrs 5 Mail invitations
3 party 10/16/2010 5 hrs 1 Select a caterer
5 party 10/16/2010 5 hrs 4 mall Print invitations
$ task all
ID Project Pri Due Completed Active Age Description
-- ------- --- ---------- ---------- ------ -----
------------------------------------
9 12/31/2010 3 hrs Look for new apartment
7 5 hrs Select some Music for after dinner
- 10/16/2010 6 hrs Come up with a guest list
- 10/16/2010 5 hrs Order a special cake
6 home 10/31/2010 5 hrs Pay rent at the end of the month
8 home 10/31/2010 5 hrs Pay rent at the end of the month
- party H 10/17/2010 10/16/2010 6 hrs Select and book a venue
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
4 party H 10/22/2010 5 hrs Design invitations
1 party H 10/31/2010 6 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
2 party 6 hrs Mail invitations
5 party 5 hrs Print invitations
3 party 6 hrs Select a caterer
9 12/31/2010 3 hrs Look for new apartment
7 5 hrs Select some Music for after dinner
- 10/16/2010 6 hrs Come up with a guest list
- 10/16/2010 5 hrs Order a special cake
6 home 10/31/2010 5 hrs Pay rent at the end of the month
8 home 10/31/2010 5 hrs Pay rent at the end of the month
- party H 10/17/2010 10/16/2010 6 hrs Select and book a venue
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
4 party H 10/22/2010 5 hrs Design invitations
1 party H 10/31/2010 6 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
2 party 6 hrs Mail invitations
5 party 5 hrs Print invitations
3 party 6 hrs Select a caterer
$ task completed
Complete Project Pri Age Description
---------- ------- --- ----- -----------------------------
10/16/2010 party H 6 hrs Select and book a venue
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
10/16/2010 6 hrs Come up with a guest list
10/16/2010 5 hrs Order a special cake
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
$ task recurring
ID Project Pri Due Recur Active Age Description
-- ------- --- ---------- ------- ------ ----- --------------------------------
8 home 10/31/2010 monthly 5 hrs Pay rent at the end of the month
8 home 10/31/2010 monthly 5 hrs Pay rent at the end of the month
$ task waiting
ID Project Pri Wait Age Description
-- ------- --- --------- ----- ----------------------
9 12/1/2010 3 hrs Look for new apartment
9 12/1/2010 3 hrs Look for new apartment
$ task blocked
ID Deps Project Pri Due Active Age Description
-- ---- ------- --- ---------- ------ ----- ------------------
4 1 party H 10/22/2010 5 hrs Design invitations
2 5 party 6 hrs Mail invitations
3 1 party 6 hrs Select a caterer
5 4 party 5 hrs Print invitations
4 1 party H 10/22/2010 5 hrs Design invitations
2 5 party 6 hrs Mail invitations
3 1 party 6 hrs Select a caterer
5 4 party 5 hrs Print invitations
$ task unblocked
ID Deps Project Pri Due Active Age Description
-- ---- ------- --- ---------- ------ ----- ------------------------------------
1 party H 10/31/2010 6 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
8 home 10/31/2010 5 hrs Pay rent at the end of the month
7 5 hrs Select some Music for after dinner
1 party H 10/31/2010 6 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
8 home 10/31/2010 5 hrs Pay rent at the end of the month
7 5 hrs Select some Music for after dinner
$ task oldest limit:3
ID Project Pri Due Active Age Description
-- ------- --- ---------- ------ ----- ------------------------------------
1 party H 10/31/2010 6 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
2 party 6 hrs Mail invitations
3 party 6 hrs Select a caterer
1 party H 10/31/2010 6 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
2 party 6 hrs Mail invitations
3 party 6 hrs Select a caterer
$ task newest limit:3
ID Project Pri Due Active Age Description
-- ------- --- ---------- ------ ----- ----------------------------------
8 home 10/31/2010 5 hrs Pay rent at the end of the month
7 5 hrs Select some Music for after dinner
5 party 6 hrs Print invitations
8 home 10/31/2010 5 hrs Pay rent at the end of the month
7 5 hrs Select some Music for after dinner
5 party 6 hrs Print invitations
$ task timesheet
10/10/2010 - 10/16/2010
Completed (3 tasks)
Project Due Description
Come up with a guest list
Order a special cake
party 10/17/2010 Select and book a venue
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
Started (0 tasks)
Completed (3 tasks)
Project Due Description
Come up with a guest list
Order a special cake
party 10/17/2010 Select and book a venue
2010/10/16 11:20 Started task
2010/10/16 11:21 Stopped task
Started (0 tasks)
$ task next
ID Project Pri Due Active Age Description
-- ------- --- ---------- ------ ----- ------------------------------------
1 party H 10/31/2010 6 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
8 home 10/31/2010 5 hrs Pay rent at the end of the month
7 5 hrs Select some Music for after dinner
1 party H 10/31/2010 6 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
8 home 10/31/2010 5 hrs Pay rent at the end of the month
7 5 hrs Select some Music for after dinner
CUSTOM REPORTS¶
You can even define your own custom report. Let's quickly create a custom report - we'll call it foo - and I can choose from a long list of fields to include in the report, but I want to see the ID, the date when I entered the task, and the description. I can specify the labels for those columns, the sort order of the report, and I can filter.$ cat >> ~/.taskrc
report.foo.description=My own report
report.foo.columns=id,entry,description
report.foo.labels=ID,Entered,Description
report.foo.sort=entry+,description+
report.foo.filter=status:pending
^D
$ task help | grep foo
task foo [tags] [attrs] desc... My own report
task foo [tags] [attrs] desc... My own report
$ task show report.foo
Config variable Value
---------------------- ----------------------
report.foo.columns id,entry,description
report.foo.description My own report
report.foo.filter status:pending
report.foo.labels ID,Entered,Description
report.foo.sort entry+,description+
$ task foo
ID Entered Description
-- ---------- ------------------------------------
4 10/16/2010 Design invitations
2 10/16/2010 Mail invitations
8 10/16/2010 Pay rent at the end of the month
5 10/16/2010 Print invitations
3 10/16/2010 Select a caterer
1 10/16/2010 Select a free weekend in November
2010/10/16 00:00 the 13th looks good
7 10/16/2010 Select some Music for after dinner
7 tasks
4 10/16/2010 Design invitations
2 10/16/2010 Mail invitations
8 10/16/2010 Pay rent at the end of the month
5 10/16/2010 Print invitations
3 10/16/2010 Select a caterer
1 10/16/2010 Select a free weekend in November
2010/10/16 00:00 the 13th looks good
7 10/16/2010 Select some Music for after dinner
CHARTS¶
The history report gives monthly totals of tasks added, completed and deleted. There is also an annual version.$ task history
Year Month Added Completed Deleted Net
---- ------- ----- --------- ------- ---
2010 October 19 3 7 9
Average 19 3 7 9
$ task history.annual
Year Added Completed Deleted Net
------- ----- --------- ------- ---
2010 19 3 7 9
Average 19 3 7 9
Average 19 3 7 9
$ task ghistory
...
$ task ghistory.annual
...
...
...
$ task summary
Project Remaining Avg age Complete 0% 100%
------- --------- ------- -------- ------------------------------
(none) 2 59 mins 50% ===============
home 1 3 hrs 0%
party 5 6 hrs 16% =====
3 projects
ADVANCED FILTERS¶
Filters are a very powerful tool. First here is an unfiltered list, which shows all tasks.$ task list
ID Project Pri Due Active Age Description
-- ------- --- ---------- ------ ----- ------------------------------------
4 party H 10/22/2010 6 hrs Design invitations
1 party H 10/31/2010 6 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
8 home 10/31/2010 6 hrs Pay rent at the end of the month
7 6 hrs Select some Music for after dinner
2 party 6 hrs Mail invitations
3 party 6 hrs Select a caterer
5 party 6 hrs Print invitations
7 tasks
4 party H 10/22/2010 6 hrs Design invitations
1 party H 10/31/2010 6 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
8 home 10/31/2010 6 hrs Pay rent at the end of the month
7 6 hrs Select some Music for after dinner
2 party 6 hrs Mail invitations
3 party 6 hrs Select a caterer
5 party 6 hrs Print invitations
$ task invit list
ID Project Pri Due Active Age Description
-- ------- --- ---------- ------ ----- ------------------
4 party H 10/22/2010 6 hrs Design invitations
2 party 6 hrs Mail invitations
5 party 6 hrs Print invitations
3 tasks
4 party H 10/22/2010 6 hrs Design invitations
2 party 6 hrs Mail invitations
5 party 6 hrs Print invitations
$ task description.contains:invit list
ID Project Pri Due Active Age Description
-- ------- --- ---------- ------ ----- ------------------
4 party H 10/22/2010 6 hrs Design invitations
2 party 6 hrs Mail invitations
5 party 6 hrs Print invitations
3 tasks
4 party H 10/22/2010 6 hrs Design invitations
2 party 6 hrs Mail invitations
5 party 6 hrs Print invitations
$ task desc.word:the list
ID Project Pri Due Active Age Description
-- ------- --- ---------- ------ ----- ------------------------------------
1 party H 10/31/2010 6 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
8 home 10/31/2010 6 hrs Pay rent at the end of the month
2 tasks
1 party H 10/31/2010 6 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
8 home 10/31/2010 6 hrs Pay rent at the end of the month
$ task desc.noword:invitations list
ID Project Pri Due Active Age Description
-- ------- --- ---------- ------ ----- ------------------------------------
1 party H 10/31/2010 6 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
8 home 10/31/2010 6 hrs Pay rent at the end of the month
7 6 hrs Select some Music for after dinner
3 party 6 hrs Select a caterer
4 tasks
1 party H 10/31/2010 6 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
8 home 10/31/2010 6 hrs Pay rent at the end of the month
7 6 hrs Select some Music for after dinner
3 party 6 hrs Select a caterer
$ task pro:party list
$ task pro.is:party list
$ task pro.not:party list
$ task pro:party pri.over:L list
ID Project Pri Due Active Age Description
-- ------- --- ---------- ------ ----- ------------------------------------
4 party H 10/22/2010 6 hrs Design invitations
1 party H 10/31/2010 6 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
2 tasks
4 party H 10/22/2010 6 hrs Design invitations
1 party H 10/31/2010 6 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
$ task pro:party limit:2 list
ID Project Pri Due Active Age Description
-- ------- --- ---------- ------ ----- ------------------------------------
4 party H 10/22/2010 6 hrs Design invitations
1 party H 10/31/2010 6 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
2 tasks, 2 shown
$ task limit:page list
ID Project Pri Due Active Age Description
-- ------- --- ---------- ------ ----- ------------------------------------
4 party H 10/22/2010 6 hrs Design invitations
1 party H 10/31/2010 6 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
2 tasks
4 party H 10/22/2010 6 hrs Design invitations
1 party H 10/31/2010 6 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
4 party H 10/22/2010 6 hrs Design invitations
1 party H 10/31/2010 6 hrs Select a free weekend in November
2010/10/16 00:00 the 13th looks good
$ task status:pending all
...
...
$ task status:waiting all
...
...
HELP¶
You'll find a quick reference page built in, with the 'help' command, or perhaps you'll want to take a look at the several man pages installed.$ task help
...
...
CREDITS & COPYRIGHTS¶
Copyright (C) 2006 - 2013 P. Beckingham, F. Hernandez.SEE ALSO¶
task(1), taskrc(5), task-faq(5), task-color(5), task-sync(5)- The official site at
- <http://taskwarrior.org>
- The official code repository at
- <git://tasktools.org/task.git/>
- You can contact the project by writing an email to
- <support@taskwarrior.org>
REPORTING BUGS¶
- Bugs in task may be reported to the issue-tracker at
- <http://taskwarrior.org>
2013-04-07 | task 2.2.0 |