A script for managing recurring tasks in TaskPaper 3. After running the script, whenever a task with a @repeat
value is marked @done
, the script immediately duplicates the task and increments the @start
and @due
dates.
Usage
Download the latest release repeat.scpt
file, and install it in TaskPaper's Command Pallet. You can run the script manually or run the script automatically when TaskPaper launches using a tool like Alfred or Keyboard Maestro.
@repeat
Add a @start
and/or @due
date, and a @repeat
value to your recurring task. The @repeat
value can be:
- the next date - e.g.
Wednesday
,June 3
,Nov 26 8:15
- the next dates, separated by comma - e.g.
Monday,Wednesday,Friday
- a duration offset from the last start/due date - e.g.
+6 hours
,+3 day
,+1 month
- repeat next March 20th at 7pm @due(2018-03-15 19:00) @repeat(March 20 7pm)
- repeat every weekday @start(2018-03-20) @repeat(Monday,Tuesday,Wednesday,Thursday,Friday)
- repeat 2 weeks after the start date @start(2018-03-15) @due(2018-03-20) @repeat(+2 weeks)
See the TaskPaper dates guide for more info on date formats.
@repeat-from-done
By default, new repeat dates anchor from @start
/ @due
. Add the @repeat-from-done
tag if you want to repeat from completion date instead.
- repeat 1 week after completion @due(2018-11-11) @repeat(+1 week) @repeat-from-done
- repeat the Monday after completion @start(2018-11-11) @repeat(Monday) @repeat-from-done