task(1) User Manuals task(1) (NAME) task - (SYNOPSIS) task [ | ] task --help task --version (DESCRIPTION) Taskwarrior (todo) . . Taskwarrior . Taskwarrior . . . ( ) . (FILTER) . 'Home': task project:Home list : task project:Home +weekend garden list : 'Home' 'weekend' 'garden' . 'garden' : description.contains:garden 'contains' (attribute modifier) ( ) . 'ATTRIBUTE MODIFIERS' . . . : task modify +work This command has no filter, and will modify all tasks. Are you sure? (yes/no) 'work' . : task task 28 task +weekend task +bills due.by:eom task project:Home due.before:today task ebeeab00-ccf8-464b-8b58-f7f2d606edfb 'and' 'or' 'xor' : task '( /[Cc]at|[Dd]og/ or /[0-9]+/ )' 'and' . (ID) UUID . ( ID UUID ): task 1 2 3 delete task 1-3 info task 1 2-5 19 modify pri:H task 4-7 ebeeab00-ccf8-464b-8b58-f7f2d606edfb info (escape ) . 'SPECIFYING DESCRIPTIONS' . (MODIFICATIONS) : task project:Home task +weekend +garden due:tomorrow task Description/annotation text task /from/to/ <- replace first match task /from/to/g <- replace all matches (SUBCOMMANDS) Taskwarrior . . . . ( verbose=nothing). context ..SH " (READ SUBCOMMANDS)" . Taskwarrior . . taskrc(5) . . task --help 'task help' . task --version Taskwarrior . task . task active . task all . task blocked . task blocking . task burndown.daily (burndown) . context . task burndown.weekly . 'burndown' 'burndown.weekly' . context . task burndown.monthly . context . task burndown.annual . context . task calendar [due| |] [y] . . 'y' . '2015' . ('6 2015') . 'due' . task colors [ | legend] (legend) . task columns [] . . . task commands . task completed . task count . context . task export JSON . (pipe) . : export-csv.pl export-sql.py export-xml.py export-yaml.pl export-html.pl export-tsv.pl export-xml.rb export-ical.pl export-xml.pl export-yad.pl task ghistory.annual . task ghistory.monthly . 'ghistory' 'ghistory.monthly' . task ghistory.weekly . task ghistory.daily . task help . task history.annual . context . task history.monthly . 'history' 'history.monthly' . context . task history.weekly . context . task history.daily . context . task ids (ID) . task : task $(task project:Home ids) modify priority:H project:Home H . : task project:Home modify priority:H . task uuids ( ) UUID . task : task $(task project:Home status:completed uuids) modify status:pending UUID project:Home status:completed pending ( ) . . task udas UDA . UDA UDA (orphan) . task information . . task list . task long . task ls ..TP task minimal . task newest . task next ( ) . task ready . . task oldest . task overdue . task projects . context . task recurring . task unblocked . task waiting . (WRITE SUBCOMMANDS) task add . context . task annotate (annotation) . task append . task delete . context . task denotate . . . context . task done . context . task duplicate . context . task edit . . . context . task import [ ...] JSON . . UUID . <<->> STDIN . import rc.recurrence.confirmation . taskrc(5) . task : import-todo.sh.pl import-yaml.pl task import-v2 Taskwarrior 2.x . 2.x 3.x . task log . context . task modify . task prepend . context . task purge . (purge) . . context . : . task start . context . task stop start . context ..SH " (MISCELLANEOUS SUBCOMMANDS)" . task calc . Taskwarrior . : task calc 1 + 1 2 task calc now + 8d 2015-03-26T18:06:57 task calc eom 2015-03-31T23:59:59 task config [ [ | '']] Taskwarrior . 'name' 'value' 'name=value' : task config name value . : task config name '' 'name=...' .taskrc : task config name task context (context) . CONTEXT . : task context work task context delete . . : task context delete work task context define . . : task context define work project:Work task context define home project:Home or +home task context define superurgent due:today and +urgent task context list . task context none . task context show . task diagnostics . . . . . UUID . task execute . (aliases) . task logo () Taskwarrior . task news Taskwarrior . . task reports . . task show [all | ] . . task stats . (context) . task summary . (context) . task sync sync Taskserver . : ( ) : recurrence=on ( ): recurrence=off recurrence . task tags . . - . . (context) . task timesheet [] . task undo . (confirmation) . task version Taskwarrior ..SH " (HELPER SUBCOMMANDS)" task _aliases (autocompletion) . task _columns . task _commands . task _config . task _context (context) . task _ids (ID) . _unique . task _show (overrides) . task _unique (attribute) . : task +PENDING _unique project task _uuids (UUID) ( ) . _unique . task _udas UDA . task _projects . _unique . task _tags . _unique . task _urgency (urgency) . task _version Taskwarrior . task _zshcommands zsh . task _zshids . task _zshuuids UUID . task _get [ ...] () DOM . . DOM : rc. tw.syncneeded tw.program tw.args tw.width tw.height tw.version context.program (Deprecated in 2.6.0) context.args (Deprecated in 2.6.0) context.width (Deprecated in 2.6.0) context.height (Deprecated in 2.6.0) system.version system.os . . 'rc.' (escape) '--' (override) . DOM . DOM . $ task _get 2.due.year 2015 DOM : .SH " (ATTRIBUTES AND METADATA)" ID ID << >> ( ) . ID ID . ID . ID . ID : task 1,4-10,19 delete +tag|-tag . + - . . (whitespace) : +-*/()<>^!%=~ ( << >> 'special tags' ) . 'nocolor' . : +nocolor +nonag nag +nocal +next 'next' . . : ACTIVE ANNOTATED (annotation) BLOCKED BLOCKING CHILD ( 2.6.0) COMPLETED completed DELETED deleted DUE (rc.due ) INSTANCE LATEST MONTH ORPHAN UDA OVERDUE PARENT ( 2.6.0) PENDING pending PRIORITY PROJECT QUARTER READY SCHEDULED TAGGED TEMPLATE TODAY TOMORROW UDA UDA UNBLOCKED UNTIL WAITING WEEK YEAR YESTERDAY +BLOCKED -BLOCKED . -BLOCKED +UNBLOCKED . . project: . status:pending|deleted|completed|waiting|recurring . priority:H|M|L priority: (High) (Medium) (Low) . due: (due-date) . recur: . scheduled: . until: . limit: . 'page' . . wait: +WAITING . +WAITING . "waiting" . depends: id1 id2 . id1 id2 . 'blocked' . ID UUID ID . '-' . entry: . modified: ..SH " (ATTRIBUTE MODIFIERS)" . : before ( under below) after ( over above) by none any is ( equals) isnt ( not) has ( contains) hasnt startswith ( left) endswith ( right) word noword ( ) : urgency ( urg) : task due.before:eom priority.not:L list before project.before:B 'A' . 'L' 'M' due:2011-01-01 due:2011-01-02 . 'under' 'below' . after before . by 'before' . : task add test due:eoy 'by' : task due.by:eoy 'before' : task due.before:eoy 'eom' 'eod' 'before' '<' '<=' . none . : task priority: list task priority.none: list . any . is . isnt is . has : task description.has:foo list task foo list description annotations 'foo' . hasnt has . startswith : task project.startswith:H list task project:H list 'H' . 'H' : task project.not:H list endswith . word : task description.word:foo list 'foo bar baz' 'dog food' . noword word ..SH " (EXPRESSIONS AND OPERATORS)" : and or xor ! < <= = == != !== >= > ( ) : task due.before:eom priority.not:L list task '( due < eom or priority != L )' list task '! ( project:Home or project:Garden )' list = . ( ). . == . != !== = == . ! . 'and' . . : task project:Home or project:Garden list . 'list' : task show report.list.filter Config Variable Value ----------------- -------------- report.list.filter status:pending : task status:pending project:Home or project:Garden list 'and' : task status:pending and project:Home or project:Garden list - 'and' 'or' : task status:pending and ( project:Home or project:Garden ) list : task '( project:Home or project:Garden )' list (escape) (shell) Taskwarrior . (attribute modifiers) (syntactic sugar) . : task foo list task /foo/ list task description.contains:foo list task description.has:foo list task 'description ~ foo' list (SPECIFYING DATES AND FREQUENCIES) (DATES) Taskwarrior . dateformat . task ... due:7/14/2008 ISO-8601 task ... due:2013-03-14T22:30:00Z task ... due:now task ... due:today task ... due:yesterday task ... due:tomorrow task ... due:23rd task ... due:3wks task ... due:1day task ... due:9hrs () () ( ) () task ... due:sow task ... due:soww task ... due:socw task ... due:som task ... due:soq task ... due:soy () () ( ) () task ... due:eow task ... due:eoww task ... due:eocw task ... due:eom task ... due:eoq task ... due:eoy task ... wait:later task ... wait:someday (wait) 12/30/9999 . task ... due:fri task ... due:goodfriday task ... due:easter task ... due:eastermonday task ... due:ascension task ... due:pentecost task ... due:midsommar task ... due:midsommarafton task ... due:juhannus . Taskwarrior . . daily, day, 1day, 1days, 2day, 2days, 1da, 2da, ... . weekdays . weekly, 1wk, 2wks, ... . biweekly, fortnight . monthly, month, 1mo, 2mo, ... . quarterly, 1qtr, 2qtrs, ... . semiannual . annual, yearly, 1yr, 2yrs, ... . biannual, biyearly, 2yr . (CONTEXT) (Context) () ( add log) . . : add burndown count delete denotate done duplicate edit history log prepend projects purge start stats stop summary tags . $ task list ID Age Project Description Urg 1 2d Sport Run 5 miles 1.42 2 1d Home Clean the dishes 1.14 $ task context home Context 'home' set. Use 'task context none' to remove. $ task list ID Age Project Description Urg 2 1d Home Clean the dishes 1.14 Context 'home' set. Use 'task context none' to remove. project:Home . $ task add Vaccuum the carpet Created task 3. Context 'home' set. Use 'task context none' to remove. $ task list ID Age Project Description Urg 2 1d Home Clean the dishes 1.14 3 5s Home Vaccuum the carpet 1.14 Context 'home' set. Use 'task context none' to remove. <> <> . <> . <> . <> . $ task context none Context unset. $ task list ID Age Project Description Urg 1 2d Sport Run 5 miles 1.42 2 1d Home Clean the dishes 1.14 3 7s Home Vaccuum the carpet 1.14 <> . $ task context define home project:Home Are you sure you want to add 'context.home.read' with a value of 'project:Home'? (yes/no) yes Are you sure you want to add 'context.home.write' with a value of 'project:Home'? (yes/no) yes Context 'home' successfully defined. <> <> . . <> . $ task context delete home Are you sure you want to remove 'context.home.read'? (yes/no) yes Are you sure you want to remove 'context.home.write'? (yes/no) yes Context 'home' deleted. <> . $ task context show Context 'home' with * read filter: '+home' * write filter: '+home' is currently applied. . $ task context define family project:Family or +paul or +nancy Are you sure you want to add 'context.family.read' with a value of 'project:Family or +paul or +nancy'? (yes/no) yes Are you sure you want to add 'context.family.write' with a value of 'project:Family or +paul or +nancy'? (yes/no) no Context 'family' successfully defined. <> . <.read>> ( ) <.write>> ( task add/log) . . . : $ task add Call Paul Created task 4. Context 'family' set. Use 'task context none' to remove. $ task 4 list ID Age Project Tags Description Urg 4 9min Family nancy paul or or Call Paul 0 ( ). <> (description) . Taskwarrior <.write>> : $ task config context.family.write project:Family Are you sure you want to change the value of 'context.family.write' from 'project:Family or +paul or +nancy' to 'project:Family'? (yes/no) yes Config file /home/tbabej/.config/task/taskrc modified. $ task context Name Type Definition Active family read project:Family or +paul or +nancy yes write project:Family yes home read +home no write +home no <> <> . context..rc. (override) . family family_report : $ task config context.family.rc.default.command family_report Taskwarrior : $ task li : $ task list $ task l list ls long . : abbreviation.minimum=3 (SPECIFYING DESCRIPTIONS) (escape) . : $ task add "quoted ' quote" $ task add escaped \' quote -- ( ) Taskwarrior : $ task add -- project:Home needs scheduling . : $ task 123 modify /from this/to that/ : $ task 123 modify "/from this/to that/" Taskwarrior : $ task add project:\'Three Word Project\' description Taskwarrior UTF8 . (CONFIGURATION FILE AND OVERRIDE OPTIONS) Taskwarrior : ~/.taskrc. : task rc: ... . TASKRC= task .. . XDG_CONFIG_HOME= task .. . task rc.: ... task rc.= ... . TASKDATA=/tmp/.task task ... 'data.location' task . (MORE EXAMPLES) : . (FILES) ~/.taskrc - : taskrc(5). TASKRC . ~/.taskrc XDG_CONFIG_HOME taskwarrior $XDG_CONFIG_HOME/task/taskrc . ~/.task task . 'data.location' TASKDATA . ~/.task/taskchampion.sqlite3 ..SH " (CREDITS & COPYRIGHTS)" (C) 2006 - 2021 T. Babej, P. Beckingham, F. Hernandez. Taskwarrior MIT . https://www.opensource.org/licenses/mit-license.php . (SEE ALSO) taskrc(5), task-color(5), task-sync(5) Taskwarrior : : (REPORTING BUGS) Taskwarrior : task 3.5.0 2016-02-24 task(1)