Repeating tasks

Set a repeat on a task and Pellet keeps it coming back.

Set a due date first

Repeat is grayed out until the task has a due date. A repeat is a rule for producing the next date, so it needs a first one to count from.

Setting one up

Open a task, give it a due date, then tick Repeat. The common ones — daily, weekly, monthly, yearly — are a couple of clicks.

Underneath, Pellet uses RRULE, the same standard your calendar app uses. That matters because it can express the awkward ones that simpler apps can’t:

What you mean	Possible
Every other Monday	✅
The 15th of each month	✅
The last day of each month	✅
The second Tuesday of each month	✅
Every Friday until the end of the year	✅
Every year, five more times	✅

What happens when you finish one

This is where Pellet differs from a checkbox that resets.

Completing an occurrence does two things: it writes a permanent record that this instance was done on this date, and it moves the parent task forward to the next date.

So you keep a real history. You can look back and see that you did the weekly review for eleven weeks and then stopped in August — which a task that simply resets can never tell you.

There’s a completion heatmap that shows exactly that, in the style of a contribution graph.

Rolling up the history

Every finished occurrence is its own file, so a daily habit collects hundreds of them. When that gets to be too many, roll them up.

Open the repeating task and press Roll up history in the Repeat Occurrences panel (it’s also in a task’s menu in the Table). Pellet moves the dates and statuses into the task itself, keeps any notes you wrote on individual occurrences in one History note beside the task, and moves the occurrence files to the trash. The heatmap and the occurrence list don’t change — every day is still there, and a day with kept notes opens the History note at that entry.

You choose what to keep from the notes: only the ones that differ from the task (the default — most occurrences are an unchanged copy), all of them, or dates only.

To have this happen on its own, set Automatically roll up occurrences older than in Settings → Tasks to a number of days. Pellet rolls up anything older than that when the vault opens and once a day after. Leave it at 0 to keep rolling up by hand.

Ghosts on the calendar

Future occurrences appear on the calendar as faint outlines. They’re not real tasks yet — they don’t clutter your lists or counts — but you can see them coming.

Skipping and stopping

You can skip a single occurrence without breaking the series, or delete the whole thing. When you delete a repeating task, Pellet asks how much of the series you mean, the way a calendar app does:

Choice	What it does
This occurrence	Skips this one; the series carries on
This and following	Ends the series here; the records of past occurrences are kept
All occurrences	Deletes the series and every recorded occurrence