Taskpaper Review

Taskpaper Review is a Ruby script which examines a Taskpaper file to update the due dates and remove un-needed @today and @due items after the tasks have been completed.

The rules

It follows these rules:

1. A line marked with @due(day name) should be updated to the next date of that day
2. A line marked with @done and a (@due or @today) should remove the due annotation
3. A line marked with @today should be set to @overdue
4. A line marked with @tomorrow should be set to @today
5. A line marked with @due(date) where the date is tomorrow should be set to @tomorrow
6. A line marked with @due(date) where the date is today should be set to @today

Usage

To use the file, call the script like:

tp-review <taskpaper-file>

This will overwrite the Taskpaper file with the revised changes.

Alternatively, tp-review takes two optional parameters when running:

tp-review <taskpaper-file> [<yyyy-mm-dd>] [--debug]

The date instructs the script to use the specified date rather than today's date.

The debug flag won't overwrite the file, just output a debug log and write the changes to standard out.

Using day to day

I store my Taskpaper files in Dropbox and have a cron job call this script every night to review the tasks in the files.