Belal Adel22 downloadsSchedule recurring and rotating tasks into a note, with automatic done and cancelled date stamps and a due-date menu.
Your recurring tasks, on schedule.
Write your routines once as Markdown lists. Clockwork Tasks creates, rotates and tidies them every day, right inside Obsidian.
Usage • Schedules • Dates • Taskscape • Installation
Clockwork Tasks reads a TaskFile, an ordinary note where every ###### heading is a routine, and writes today's tasks into an output note. It is made for habits, chores and self-improvement lists: things that come back every day or every week, or that you want to rotate through one at a time.
No other plugin required, However I recommend installing Tasks plugin as it really helps you organize.
Add a clockwork-tasks code block to any note, then a ###### (level 6) heading for every routine:
```clockwork-tasks
output: TODO/Daily Tasks.md
```
###### Daily
- [ ] Drink water
- [ ] Read 10 pages
###### Daily [cyclic]
- [ ] Workout legs
- [ ] Workout back
- [ ] Workout chest
###### Saturday
- [ ] Clean the desk
Every day, Clockwork Tasks adds that day's tasks to TODO/Daily Tasks.md:
- [ ] Drink water 📅 2026-11-15 #active #daily
- [ ] Workout back 📅 2026-11-15 #active #daily-cyclic
Only output is required. The other lines are optional:
| Parameter | What it does | Default |
|---|---|---|
output |
Note that receives the generated tasks (with or without .md) |
required |
trigger |
When the day rolls over. Currently only daily is supported |
daily |
anchor |
Start date (YYYY-MM-DD) that [cyclic] lists count from |
set in the plugin settings |
What happens each day
###### Done heading of the output note. A task that is already in the note, done or not, is never added twice.###### Done, newest first, and lose their #active tag.#active too (you can turn this off), so #active always means "today".Clockwork Tasks adds a checkbox under the code block of every TaskFile:
- [ ] 🔁 Restart Clockwork Tasks (regenerate today's tasks) %%clockwork-tasks:restart%%
Tick it after editing a list and today's tasks are regenerated straight away. The plugin unticks it afterwards. The %%...%% part is an Obsidian comment, so it stays invisible when the note is rendered.
[!TIP] Because duplicates are never added, regenerating is always safe. It only adds what is missing.
A heading is a schedule followed by optional [modifiers].
| Heading | Runs |
|---|---|
Daily |
every day |
Saturday, Sat, Sun, Monday and Friday |
only on those days (could use full names or abbreviations: mon tue wed thu fri sat sun) |
Twice a week:
###### Mon, Thu
- [ ] Go to the gym
Three times a week:
###### Mon, Wed, Fri
- [ ] Practice English
| Modifier | What it does |
|---|---|
[cyclic] / [cyclic: 2] |
Gives you N tasks per day (default 1) and rotates through the list, so every task gets its turn. |
[days-off: fri, sat] |
Skips the list on those days. |
[custom-name: deep-work] |
Uses #deep-work as the tag instead of the automatic tag. |
[disabled] |
Switches the list off without deleting it. |
Study two subjects every weekday, excluding weekends.
###### Daily [cyclic: 2] [days-off: fri, sat]
- [ ] Mathematics
- [ ] Physics
- [ ] Spanish
- [ ] Biology
TIP: could set custom name like 'study-routine' by adding [custom-name: study-routine]
[!NOTE]
[cyclic]needs no stored state: the task of the day is calculated from the number of days since theanchordate. The same day always gives the same tasks, and all your devices agree.
The automatic tag is built from the schedule and modifiers, for example #daily, #saturday or #daily-cyclic.
[!CAUTION] Headings and nested tasks
Only
######(level 6) headings become lists, and only top-level unchecked tasks (- [ ] ...) under them are used. Indented sub-tasks are ignored. A heading Clockwork Tasks doesn't understand is skipped with a warning (notice + console).
Clockwork Tasks got a quality of life features similar to Tasks plugin.
| You do | You get |
|---|---|
Tick a task [x] |
✅ 2026-11-15 added at the end of the line, instantly |
Cancel a task [-] |
❌ 2026-11-15 added |
| Untick a task | the date is removed |
| Go from done to cancelled (or back) | the stamp is swapped in one step |
The format is the emoji format used by the Tasks plugin, so nothing breaks if you use both.
Type on an open task and a small menu appears at your cursor:
tom, fri, in 3 days, 1w or 2026-12-01.Esc hides the menu until you type again. If the menu is in your way, switch off Show the menu while typing and it will only appear after you type 📅 yourself.
I use this setup myself, so I made sure that Tasks and Clockwork Tasks work well together without interfering with each other.
[!TIP] Clockwork Tasks builds the habit. Taskscape shows the progress.
If you have been using Clockwork Tasks for a while, the output note quietly becomes a record of everything you committed to and everything you finished.
Taskscape (by the same author) turns that record into something you can look at:
The two plugins speak the same language. Clockwork Tasks writes 📅 due dates and ✅ / ❌ completion dates, and Taskscape reads exactly those, so there is nothing to configure. Point it at your output note:
```taskscape
source: TODO/Daily Tasks.md
view: summary
```
If you like Clockwork Tasks, install Taskscape as well. After a few weeks, that overview of what you've achieved is the most motivating part.
| Setting | Default | What it does |
|---|---|---|
| Config block language | clockwork-tasks |
Code-block language that marks a TaskFile |
| Rollover time | 00:00 |
When a new day starts. 04:00 keeps 00:00–03:59 as the previous day |
| Default anchor date | 2026-11-15 |
Where [cyclic] lists start counting. Override per file with anchor: |
| Active tag | #active |
Tag added to today's tasks |
| Done heading | ###### Done |
Heading that finished tasks are moved under |
| Deactivate stale tasks | on | Remove the active tag from unfinished tasks due before today |
| Done dates (✅) | Auto | Stamp ✅ when a task is ticked, in any note |
| Cancelled dates (❌) | Always on | Stamp ❌ when a task is cancelled |
| Due-date menu (📅) | Auto | The menu described above |
| Show the menu while typing | on | Off = the menu appears only after you type 📅 |
| Check interval | 5 min | A safety-net check for a new day, set as minutes + seconds (for example 5 min 21 s). |
| Run on startup | on | Run shortly after Obsidian starts |
| Debug logging | off | Print what each run decided to the console |
| Command | What it does |
|---|---|
| Run now | Run the generator immediately and show what it did |
| Force regenerate today's tasks | Regenerate even if today was already done |
| Clear trigger state | Forget which days have run |
| Show due-date menu at cursor | Open the due-date menu without creating a task (bind a hotkey if you like) |
| Diagnose editor features | Show which features are active, for troubleshooting |
From the Community plugins browser: search for Clockwork Tasks, install and enable.
Manually: download main.js and manifest.json from the latest release, put them in <your vault>/.obsidian/plugins/clockwork-tasks/, then reload and enable the plugin.
Clockwork Tasks is plain JavaScript with no dependencies. Edit the files in src/, then run node build.js to produce main.js.
Clockwork Tasks makes no network requests and collects no telemetry. It reads your TaskFiles, writes to the output notes they name, and adds date stamps to the tasks you tick or cancel. Your settings and the "already ran today" state are stored in the plugin's own data.json locally.