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.
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.
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.
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