Search...Search plugins and themes...
⌘K
Sign in
  • Get started
  • Download
  • Pricing
  • Enterprise
  • Account
  • Obsidian
  • Overview
  • Sync
  • Publish
  • Canvas
  • Mobile
  • Web Clipper
  • CLI
  • Learn
  • Help
  • Developers
  • Changelog
  • About
  • Roadmap
  • Blog
  • Resources
  • System status
  • License overview
  • Terms of service
  • Privacy policy
  • Security
  • Community
  • Plugins
  • Themes
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

Clockwork Tasks

Belal AdelBelal Adel22 downloads

Schedule recurring and rotating tasks into a note, with automatic done and cancelled date stamps and a due-date menu.

Add to Obsidian
  • Overview
  • Scorecard
  • Updates1

Clockwork Tasks

Clockwork Tasks

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.

Clockwork Tasks Overview

No other plugin required, However I recommend installing Tasks plugin as it really helps you organize.

Task Creation Demo

Usage

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

  • A day's tasks are created once, the first time the plugin runs that day: at startup, every few minutes, or right after midnight.
  • Tasks are inserted just above the ###### Done heading of the output note. A task that is already in the note, done or not, is never added twice.
  • Completed tasks move under ###### Done, newest first, and lose their #active tag.
  • Unfinished tasks from earlier days lose #active too (you can turn this off), so #active always means "today".
  • Several TaskFiles can feed the same output note.

Regenerate today's tasks

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.

Schedules and modifiers

A heading is a schedule followed by optional [modifiers].

Schedules – When should tasks appear?

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)
Examples:

Twice a week:

###### Mon, Thu
- [ ] Go to the gym

Three times a week:

###### Mon, Wed, Fri
- [ ] Practice English

Modifiers – How should tasks behave?

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

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 the anchor date. 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).

Dates and the due-date menu

Clockwork Tasks got a quality of life features similar to Tasks plugin.

  1. Automtically stamp ✅ done tasks and ❌ canceled tasks with today's date.
  2. Automtically and easily generate 📅 due dates through a menu.

1. Done and cancelled dates

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.

2. Due-date menu

Type on an open task and a small menu appears at your cursor:

  1. 📅 Due date (or ⏎ New line). Press Enter on Due date and the 📅 is inserted for you.
  2. Pick a date: Today, Tomorrow, the next weekdays, Next week. You can also type to filter, such as 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.

Due-date menu + stamps demo

Using it with the Tasks plugin

I use this setup myself, so I made sure that Tasks and Clockwork Tasks work well together without interfering with each other.

  • Done dates and the due-date menu are on Auto by default: they step aside while the Tasks plugin is enabled and take over when it is disabled.
  • Cancelled dates stay on either way, since the Tasks plugin doesn't add them. Each can be set to Auto, Always on or Off.

Works great with Taskscape

[!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:

  • a Gantt timeline of how long each task stayed open,
  • a summary that groups repeating tasks: how often they appeared, when you first and last did them, and which ones slipped.

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.

  • Taskscape on GitHub
  • Taskscape in Obsidian's plugin browser

Settings

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

Commands

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

Installation

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.

Building from source

Clockwork Tasks is plain JavaScript with no dependencies. Edit the files in src/, then run node build.js to produce main.js.

Privacy

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.

License

MIT

HealthExcellent
ReviewPassed
About
Create daily and rotating routines from Markdown lists and write today's tasks into a chosen output note. Rotate cyclic lists, move completed items under a Done heading, and tag current tasks with #active so routines are generated and tidied each day.
TasksAutomationDates
Details
Current version
1.2.0
Last updated
5 days ago
Created
6 days ago
Updates
1 release
Downloads
22
Compatible with
Obsidian 1.4.0+
Platforms
Desktop, Mobile
License
MIT
Report bugRequest featureReport plugin
Author
Belal AdelBelal Adelbelaladeldev
GitHubbelaladeldev
  1. Community
  2. Plugins
  3. Tasks
  4. Clockwork Tasks

Related plugins

Rollover Daily Todos

Rollover any unchecked checkboxes from your last daily note into today's note.

Tasks

Track tasks across your vault. Supports due dates, recurring tasks, done dates, sub-set of checklist items, and filtering. Maintained by Clare Macrae and Ilyas Landikov, created by Martin Schenck.

Vault Todos

Collect all outstanding TODOs from your vault and presents them in lists Today, Scheduled, Inbox and Someday/Maybe.

Day Planner

Turn tasks from daily notes, the Tasks plugin, and calendars into time blocks on an editable timeline, with built-in time tracker.

Update modified date

Automatically update a frontmatter modified date field when the file is modified.

Vault Changelog

Maintain a changelog of recently edited notes.

Day Planner OG

Day planning from a simple task list in a Markdown note (bare bones, preserves the features and behavior of the original plugin).

Reminder

Manage Markdown TODOs with reminder.

Task Collector

Change task status and collect tasks within a document using hotkeys and context menus.

Todoist Sync

Materialize Todoist tasks within your notes.