A VS Code extension that is the default editor for .todo files.
File format
- unassigned task
[alice]
X Create a plugin
? (2026-10-01) Check if it opens
[bob]
- Check if save is stable
Marker
Meaning
Color
X
done and checked
green
?
done, but needs to be checked
yellow
-
open
red
[username] starts a user section; every task below it belongs to that user.
(YYYY-MM-DD) right after the marker is the due date. Past due dates are shown in red
(except for tasks that are done and checked).
All other lines are kept untouched.
Editor features
Click the status badge to cycle - → ? → X.
Edit task text inline (Enter to apply, Escape to cancel) and the due date with a date picker.
Drag a task by its handle (⠿) to another user's section, or onto another task to put it before that task.
New tasks are added to the section of the active user (the section is created if needed).
The section of the active user is highlighted in red. The active user is your GitHub account
(use the Sign in with GitHub button) or the todoFile.username setting, if set.
Every change is saved to the file immediately, and changes to the file are shown in the editor immediately.
Development
npm install
npm run compile
npm test
Press F5 in VS Code to launch an Extension Development Host.
