-
Wiki HOME | About | Bugs | Changelog | Commands | Developers | Docs | FAQ | Features | Gallery | Glossary | Mission | Philosophy | Plug-ins
see also Features
see also configuration
CRUFT ALERT! this page needs updating, and is sorely wrong in several places.
(this table is under construction)
(these need to be sortable via http://tetlaw.id.au/view/blog/table-sorting-with-prototype/ )
or using native Redmine methods, whichever is easier
task¶
typical command-line usage: task <command | switch> <parameters>
| command | canonical | sw | parameters | interactive | status | vers | issue# | notes |
|---|---|---|---|---|---|---|---|---|
| active | [tags] [attrs] [desc...] | comma |  |
Shows all task that are started, but not completed | ||||
| add | -a | [tags][attrs] desc... | (a)dd | |
1.2 | Adds a new task | ||
| annotate | -o | ID desc... | ann(o)te | |
Adds annotation to existing task | |||
| append | -A | ID [tags][attrs] desc... | (A)ppend | |
Appends to existing task | |||
| calendar | -C | [number] | (C)alendar | |
Shows a monthly calendar, with due tasks marked | |||
| color | |
Display all possible colors | ||||||
| completed | [tags][attrs] desc... | |
Chronological listing of all completed tasks matching the specified criteria | |||||
| custom | [tags] [attrs] [desc...] | F12 | |
My custom report | ||||
| delete | -D | ID | (D)elete, del | |
Deletes the specified task(s) | |||
| done | -d | ID [tags][attrs][desc..] | (d)one | |
Marks the specified task as completed | |||
| duplicate | ID [tags][attrs][desc..] | & | |
Duplicates the specified task | ||||
| edit | -E | ID | (E)dit | |
Launches an editor to let you modify all aspects of a task directly, use with caution | |||
| export | [tags][attrs] | F12 | |
Exports all tasks as a CSV file | ||||
| ghistory | (h)istory | |
Shows a graphical report of task history, by month | |||||
| gstats | % | |
show graphical stats | |||||
| help | F1, ? | |
Shows the long usage text | |||||
| history | -h | (h)istory | |
Shows a report of task history, by month | ||||
| ID | [tags] [attrs] [desc...] | |
Modifies the existing task with provided arguments | |||||
| import | F12 | |
Imports tasks from a variety of formats | |||||
| info | -i | ID | (i)nfo | |
Shows all data, metadata for specified task | |||
| list | [tags] [attrs] [desc...] | F3,F12 | |
Lists all tasks matching the specified criteria | ||||
| long | [tags] [attrs] [desc...] | F4,F12 | |
Lists all task, all data, matching the specified criteria | ||||
| ls | [tags] [attrs] [desc...] | F2,F12 | |
Minimal listing of all tasks matching the specified criteria | ||||
| newest | [tags] [attrs] [desc...] | F12 | |
Shows the newest tasks | ||||
| next | -N | [number] | (N)ext | |
Shows the most important tasks for each project | |||
| oldest | [tags] [attrs] [desc...] | F12 | |
Shows the oldest tasks | ||||
| overdue | ! | |
Shows all incomplete tasks that are beyond their due date | |||||
| projects | -p | (p)rojects | |
Shows a list of all project names used, and how many tasks are in each | ||||
| replace | ? | |
ID /from/to/ performs one substitution on the task description, ID /from/to/g for all occurances in that description | |||||
| start | -s | ID | (s)tart | |
Marks specified task as started | |||
| stats | [tags] [attrs] [desc...] | # | |
Shows task database statistics | ||||
| stop | -s | ID | (s)top | |
Removes the 'start' time from a task | |||
| summary | period | |
Shows a report of task status by project | |||||
| tags | -T | (T)ags | |
Show a list of all tags used | ||||
| task | [tags] [attrs] [desc...] | |
invoked without parameters, will start an interactive session, at a default screen;Next Actions | |||||
| timesheet | [weeks] | |
Shows a weekly report of tasks completed and started | |||||
| undelete | -U | ID | (U)ndelete | |
Undeletes the specified task, provided a report has not yet been run | |||
| undo | -u | ID | (u)ndo | |
reverts changes made | |||
| update | [tags] [attrs] [desc...] | |
used to make changes to records | |||||
| version | (V)ersion | |
Shows the task version number | |||||
| wait | (w)ait | |
toggle task(s) status:waiting | |||||
| waiting | (W)aiting | |
||||||
| attributes | : | displays a full list of attributes in use | ||||||
| breaks | -b | h d w m y | (b)reaks | break letter to toggle or "b" to cycle | ||||
| contacts | -c | [tags] [attrs] [desc...] | (c)ontacts | toggles inclusion of contact data, to be combined with task searches. (contacts at the top) | ||||
| contexts | @ | lists contexts (TBD) | ||||||
| depends | ^ | add/ change/ remove dependency (when available) | ||||||
| encrypt | cr(Y)pto | to keep things safe | ||||||
| execute | e(x)ecute | launches exec:<action> script if any else looks for first key-action words in <desc> corresponding to existing scripts in .taskrc | ||||||
| find | -F | (F)ind-list or "\" | list saved searches | |||||
| games | (G) | Games | ||||||
| groups | -g | [tags] [attrs] [desc...] | (g)roups | listing of groups (contacts) | ||||
| index | -i | (I)ndex | displays full contact listing and switches to Index-key mode (scroll to alpha-numeric) | |||||
| journal | -j | (j)ournal | displays journal ->[append text] or <enter> to edit | |||||
| Jukebox | -j | (J) | Jukebox | |||||
| keys | -k | (k)eys | displays full key reference "card" invalid-for-context entries "grayed out" | |||||
| ledger | (L) | Ledger | ||||||
| (M) | ||||||||
| messaging | (m) | messaging | ||||||
| next | (N)ext | user definable list of Next Actions both automatically and manually selected (interactive tasks default view) | ||||||
| next | (n)ext | manually mark (or un-mark) selected item(s) as Next Actions (could be as simple as adding +NA tag) | ||||||
| open | (O)pen | opens console file manager () | ||||||
| (P)rint | (TBD) based on export.pdf.faves? | |||||||
| quit | (Q) | quits with no prompt | ||||||
| quit | (q)uit | are you sure (Y/n) ? ...or not | ||||||
| random | * | displays random task | ||||||
| rating | + | increments rating:<int> (no rating treated as rating:3) | ||||||
| reports | f12 | list all available reports / exports / imports | ||||||
| f2-f10 | trigger top 9 reports (of unlimited #, can be either task or contact reports) | |||||||
| revert | BkSpc | revert changes in status | ||||||
| review | (R)eview | launches a series of listings for review | ||||||
| sc | $ | opens interactive spreadsheet calculator | ||||||
| search | [tags] [attrs] [desc...] | (f)ind or "/" | needs no command at CLI | |||||
| settings | m(y) stuff | access to .taskrc settings | ||||||
| show.all | (Z)show.all | unhide status:waiting status:someday and bypass user-created exclusions list (.taskrc) | ||||||
| show.done | (z)show.done | toggle show done | ||||||
| sync | (S)ync | ... this feature may require some further discussion(in the distant future ;-) | ||||||
| verbosity | (v)erbose | toggle display of verbosity-bar for verbose confirmation stuff | ||||||
| (K)? | ||||||||
| <enter> | is highly context sensitive, but tends to drill down (selection -> info -> form -> edit) as well as confirming search string (find mode) and then returning to onekey mode | |||||||
| <esc> | is as context sensitive as <enter> but tends to back out (canceling dialogs, abandoning search strings and returning to onekey, resetting some things to defaults) and ultimately, exiting the program | |||||||
| <tab> | is used primarily for completion, but may be used with (proposed) data.forms | |||||||
| arrow up/dn | to select (see:selection) | |||||||
| f11 | toggles "full screen" mode (more like "hide certain elements" mode) <esc> also un-hides | |||||||
| Home/End | in lists; top/bottom, in "single screen" first/last of series, arrow keys left and right move selected column (which changes sort keys) "<" to reverse sort order (effect not "sticky") ">" to reset sort order | |||||||
| PgUp/PgDn | scroll through lists (a page at a time) but when on single screen reports (like (i)nfo, or (#)stats) PgUp (or PgDn) will flip to the next (or previous) record |