README file from
GithubTask Date Links
Adds a real daily note link to a task when you complete it, so backlinks show what you finished each day.
Tasks writes plain text, such as ✅ 2026-10-10. This plugin adds the link.
Quick start
- [x] Send the invoice ✅ 2026-10-10
For old dates, run "Link the done dates in the current note", or select lines and run "Link the done dates in the selection". Select "Link the dates" to apply it.
Features
A link when you complete a task
When the Tasks plugin writes a done date, Task Date Links adds a link to that day before the Tasks fields:
- [x] Send the invoice to Ana [[2026-10-10]] ✅ 2026-10-10 ^invoice
The link goes before the fields because Tasks reads fields from the end. Dates, priority, recurrence and block ids stay readable by Tasks.
Code blocks, also in callouts and lists, and front matter are skipped.
Only the finished copy of a recurring task gets a link. Uncheck removes links added on completion in the same session. After a setting change, note rename or back-fill, those links stay. Links you typed and back-filled links stay.
The daily note shows what you finished
The daily note’s Backlinks pane shows completed tasks with their whole lines. Graph view shows the same links.
Back-fill with a preview and one undo
For old dates, run "Link the done dates in the current note", or select lines and run "Link the done dates in the selection".
The preview shows up to 40 changed lines and counts the rest. Select "Link the dates" to apply it. "Undo the last back-fill" restores the lines, except those you edited since.
Each Free or Pro back-fill accepts at most 5,000 notes and 20,000 changed lines total. Larger plans are refused before writes. Use smaller selections or Pro folder rules. Apply checks the full plan again; notes changed afterward are skipped for another preview.
Undo keeps conflicts, missing notes and I/O failures across reload. Restore missing notes or exact linked lines, then retry. Finish recovery before another back-fill replaces it. Overlaps show busy notices. Re-enable retries failed recovery saves after pending writes. Failed enables report errors; enable again when storage recovers. Operations are not atomic.
Your date format and link text
The core Daily notes format is the default. Override it with a moment format, such as DD-MM-YYYY. Formats with unsafe characters (#, |) fall back to YYYY-MM-DD. Link text format MMM D gives [[2026-10-10|Oct 10]].
Daily notes in a folder
The plugin uses the core Daily notes folder. For Journal/Daily, it writes [[Journal/Daily/2026-10-10|2026-10-10]]. The date text links to that folder, even with duplicate note names.
Set "Daily note folder" to override the core folder. The date format gives the path inside it.
Completion and back-fill use this folder. A line that links the date with or without the folder gets no second link. Settings reject unsafe folders and . or .. segments. Unsafe saved folders fall back to date links without a folder.
More dates and week and month notes (Pro)
Turn on the start, scheduled, due or created date, and a completed task gets a link for each one. Turn on the weekly or monthly note, and each linked date also links its week or month, such as [[2026-W41]] and [[2026-10]]. Folder rules let you use the plugin in some folders only, or skip a folder such as Archive.
Back-fill the whole vault (Pro)
"Link the done dates in the whole vault" back-fills the whole vault after a preview.
Install
Open Settings, then Community plugins, then Browse, and search for "Task Date Links". Select Install, then Enable.
To install by hand, download main.js, manifest.json and styles.css from the latest release. Put them in <vault>/.obsidian/plugins/task-date-links/. Reload the community plugins, then turn on Task Date Links.
Usage
Complete a task with "Toggle task done" in Tasks. The link appears after Obsidian saves the done date.
Only today’s or yesterday’s done dates get automatic links.
| Command | What it does |
|---|---|
| Link the done dates in the current note | Preview, then link the done dates of the note. |
| Link the done dates in the selection | The same for the selected lines only. |
| Link the done dates in the whole vault | The same for the whole vault. Pro. |
| Undo the last back-fill | Puts back the lines of the last back-fill. |
To keep one note out, add the property task-date-links: false to it. The plugin then adds no link on completion there. Each back-fill skips the note and counts it in the preview and the final notice. Only the boolean false counts, not the quoted text "false".
A link that you delete by hand is not added again in the same session.
Pro
The free version has no time limit.
To get Pro:
- Sponsor theluckystrike on GitHub Sponsors with $5 a month, or $15 once.
- In Obsidian, open the settings of Task Date Links and select "Sign in with GitHub".
- Paste the code the plugin shows at github.com/login/device and approve.
Settings
After a minor or major update, this plugin opens one What's new tab in the background. The tab and settings card suggest other NoteMods plugins and Zovo Chat and link to notemods.com for feedback (privacy). The tab sends no data. Turn the tab off in Settings.
| Setting | What it does |
|---|---|
| Pro | Sign in, status, Refresh and Sign out. |
| Link a task when it is completed | On by default. |
| Daily note format | A moment format. Empty means the format of the Daily notes plugin. |
| Daily note folder | Empty uses the core Daily notes folder. / uses the vault root. |
| Link text format | An optional moment format for the text after the pipe. |
| Remove the link when a task is reopened | On uncheck, removes a link that the plugin added in the same session. |
| Start, scheduled, due and created date | Pro. Link these dates of a completed task. |
| Weekly and monthly note | Pro. Link the week or month of each linked date, with a format for each. |
| Only these folders, Skip these folders | Pro. One folder for each line. |
FAQ
Do I need the Tasks plugin?
No. The plugin reads done dates from notes, including dates typed by hand.
Will it break my tasks?
The tests run with the real Tasks plugin. They check emoji fields, Dataview fields, recurrence rules, block ids and Windows line endings, and Tasks reads each line after the link is in it.
Do my Tasks queries still work?
Queries on dates, status and priority work as before, because the fields do not change. The description of the task now holds the link text. A query such as description includes 2026 sees it.
What happens if I uninstall the plugin?
The links stay in your notes as normal links.
Does it work on a phone or tablet?
It is not desktop only and uses no Node.js API. The tests run on desktop only.
Payment, account and network
The core features are free. Pro features need a GitHub Sponsors sponsorship of theluckystrike: $5 a month or more, or $15 once. A total payment of $15 meets the payment requirement for Pro without further payment. Sign-in and the checks below still apply. Your notes stay readable and editable with or without Pro.
One payment turns on Pro in every NoteMods plugin.
GitHub handles the payment. Sponsor at https://github.com/sponsors/theluckystrike?frequency=one-time&metadata_source=task-date-links. You need no account for the free features. Pro needs the GitHub account that sponsors.
Until you select "Sign in with GitHub" in the settings, Task Date Links makes no network requests. Sign in uses the GitHub device flow. Task Date Links sends its public client ID and the scope read:user to https://github.com/login/device/code and shows you a code. While you enter the code at https://github.com/login/device, it asks https://github.com/login/oauth/access_token every few seconds to check the sign-in status. The scope permits profile reads only. GitHub needs this access to show the sponsorship tier. It grants no repository scope and no write access.
After sign in, Task Date Links sends one query to https://api.github.com/graphql. It checks if the signed-in account sponsors theluckystrike. It asks for the tier and the total payment to theluckystrike. The plugin reuses a successful check for 7 days. Failed checks can retry after 6 hours. Select Refresh to request an earlier check. It sends no note content, file names or other vault data, and it has no telemetry.
After a successful check, Pro can work offline for up to 14 days. Sign out or a negative sponsorship answer turns Pro off. The plugin stores the GitHub token through the secret storage API of Obsidian. It does not put the token in its saved settings or its local sponsorship data. The local storage of this device keeps your GitHub login, the tier and the time of the last check. Sign out clears the token. You can also revoke the access in your GitHub settings, under Applications.
Support
Report bugs and feature requests in this repository's issue tracker.
npm ci
npm run build
npm test
License
MIT
Community
Questions, bugs or plugin ideas? Talk to me and other Obsidian users in Zovo Chat on Telegram. It has a topic for these plugins. You can also open an issue here.