taskn is a note taking system for TaskWarrior, designed as an expansion of the tasknote script. It offers the following additional features:
pip install taskn easy_install taskn
Alternately, you can install from source with the following sequence of operations:
git clone email@example.com:tychoish/taskn.git cd taskn python setup.py install
|||If you’re interested in packaging taskn for a system package manager, please do coordinate with me and I’ll add that to the instructions here.|
When you install taskn you will have two new shell scripts in your path: taskn and tasknadm. The following sections provide an inventory of the interface common operations.
taskn commands generally take the following form:
taskn <options> <task_id>
<options> specifies one of the following options, while <task_id> is one of the current ordinal task identifiers. Given the following command:
taskn will open a note for task #12 in your editor. Consider the following assumptions and finer points.
The following examples all specific “long form” command line options. Short forms exist for convince.
If you call taskn without any arguments, taskn prints a sequence of YAML documents for each note associated with a pending task. To list all, including completed tasks, use the following operation:
You can filter results based on status using the --filter options:
taskn --list --filter deleted
Possible filters are: pending, deleted, completed, waiting, and recurring.
You can use the --view and --format arguments to display task and note information on the console, as in the following:
taskn --view 12
This operation outputs a YAML document of the task, and adds the note to the output. To return JSON output, use --format as follows:
taskn --view 12 --format json
taskn does not sanitize the YAML output of note data.
The following options allow users to control default behavior.
tasknadm has two sub-commands:
Like taskn, taskadm has the following (related options):