Skip to content

0.6.0

Pre-release
Pre-release
Compare
Choose a tag to compare
@github-actions github-actions released this 25 Apr 19:25

Changes

Tasks now supports recurring tasks πŸ” πŸŽ‰

Recurring tasks (repetition)

Tasks can be recurring.
In order to specify a recurrence rule of a task, you must append the "recurrence signifier πŸ”" followed by the recurrence rule.
For example: πŸ” every weekday means the task will repeat every week on Monday through Friday.

When you toggle the status of a recurring task to anything but "todo" (i.e. "done"), the orginal task that you wanted to toggle will be marked as done and get the done date appended to it, like any other task.
In addition, a new task will be put one line above the original task.
The new task will have the due date of the next occurrence after the due date of the original task.

Take as example the following task::

- [ ] take out the trash πŸ” every Sunday πŸ“… 2021-04-25

If you mark the above task "done" on Saturday, the 24th of April, the file will now look like this:

-   [ ] take out the trash πŸ” every Sunday πŸ“… 2021-05-02
-   [x] take out the trash πŸ” every Sunday πŸ“… 2021-04-25 βœ… 2021-04-24

For best compatibility, a recurring task should have a due date and the recurrence rule should appear before the due date of a task.

Right now there is no direct feedback to whether your recurrence rule is valid.
You can validate that tasks understands your rule by checking that the task includes the recurrence rule when it is rendered, for example in the markdown preview of the file where it is defined or in another tasks query.
When it is shown (with the checkbox on the left), then tasks understands it.

Examples of possible recurrence rules (mix and match as desired; these should be considered inspirational):

  • πŸ” every weekday (meaning every Mon - Fri)
  • πŸ” every week on Sunday
  • πŸ” every 2 weeks
  • πŸ” every 3 weeks on Friday
  • πŸ” every 2 months
  • πŸ” every month on the 1st
  • πŸ” every 6 months on the 1st Wednesday
  • πŸ” every January on the 15th
  • πŸ” every year