« Previous -
Version 82/84
(diff) -
Next » -
Current version
David Patrick, 02/20/2010 07:02 PM
-
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.
(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 |