README file from
GithubReal Tasks
An Obsidian plugin that deletes task lines shortly after their checkbox is ticked. Your notes keep only the tasks that still need doing — no graveyard of strikethroughs, no manual cleanup.
Why
Most task workflows leave completed tasks in the file as - [x] lines. That's great if you want a historical log; it's noise if you want your notes to function like a todo app. Real Tasks removes that noise automatically while preserving undo.
How it works
- When you check off a task in the editor, Real Tasks waits 800 ms, then removes the whole line via the editor API. Undo (
Cmd/Ctrl-Z) restores it. - When a task gets completed programmatically — for example by Dataview checkbox clicks in an embedded query, or by a sync client — Real Tasks catches the
vault.modifyevent, waits 400 ms, and rewrites the file with the completed lines stripped out. - A ribbon button and command insert a new
- [ ]task line at the cursor, ready to type.
Features
- Auto-delete completed task lines (
- [x],- [X],* [x],+ [x]). - Short delay after completion to allow for accidental clicks (
Cmd/Ctrl-Zto recover). - Works from both the editor and external writes (Dataview, sync, external tools).
- Ribbon icon and command Insert new task for quick task creation.
- Command Sweep completed tasks in this note now for ad-hoc cleanup.
- Desktop and mobile support.
Usage
- Install and enable the plugin.
- Write tasks as normal:
- [ ] something to do. - Check the box. ~1 second later the line vanishes.
- Accidentally checked? Press
Cmd/Ctrl-Zwithin the delay window, or immediately after, to restore the line. - Tap the ribbon icon (a check-square) to insert a new task at your cursor. Optionally bind
Insert new taskto a hotkey in Settings → Hotkeys.
Commands
| Command | Description |
|---|---|
Real Tasks: Insert new task |
Insert a - [ ] line at the cursor. |
Real Tasks: Sweep completed tasks in this note now |
Immediately remove all completed tasks from the active note. |
Compatibility
- Tested on Obsidian
1.4.0and above. - Desktop and mobile (iOS, Android).
- Compatible with Dataview
TASKqueries — checking a task in an embedded Dataview result triggers the auto-delete.
Installation
Community plugins (once published)
- Open Settings → Community plugins.
- Search for Real Tasks.
- Install and enable.
Manual install
- Download
main.jsandmanifest.jsonfrom the latest release. - Create a folder
<VAULT>/.obsidian/plugins/real-tasks/. - Drop both files inside.
- Enable the plugin in Settings → Community plugins.
Settings
No settings page in this release. Everything runs on sensible defaults. Future versions may expose the delete delay and checkbox filters.
Development
main.jsis hand-written plain JavaScript — no build step, no bundler, no TypeScript.- To modify locally, edit
main.jsthen reload the plugin via Settings → Community plugins toggle, or restart Obsidian.