Plain-text task lists and outlines for VS Code — compatible with TaskPaper format.
Open .taskpaper, .tasks, or .todo files. Use projects, tasks, notes, @tags, archive, sidebar, and item-path search.
Unofficial. Tasky works with TaskPaper-compatible plain text. Not affiliated with Hog Bay Software.
Features
| Feature | Details |
|---|---|
| File types | .taskpaper, .tasks, .todo |
| Format | TaskPaper-compatible: projects (:), tasks (- ), notes, @tags |
| Toggle Done | @done / @done(YYYY-MM-DD) |
| Archive @done | Move completed items to Archive: |
| Activity Bar sidebar | Home · Projects · Searches · Tags |
| Item-path search | e.g. //not @done, project Inbox //task |
| Tag autocomplete | Type @ and @tag( |
| Folding & symbols | Indent folding, Outline view |
| Status bar | done/total tasks + active filter |
Quick start
- Install Tasky
- Open or create a
*.taskpaperor*.tasksfile - Use the Tasky Activity Bar icon for the outline sidebar
- Command Palette → Tasky: Open Welcome Example
Inbox:
- Write the report @due(2026-07-15)
- Review PR @today
- Ship it @done(2026-07-13)
Keyboard shortcuts
| Action | macOS | Windows/Linux |
|---|---|---|
| Toggle Done | ⌘D |
Ctrl+D |
| Archive @done | ⌘⇧A |
Ctrl+Shift+A |
| Toggle @today | ⌘⌥Y |
Ctrl+Alt+Y |
| Tag With… | ⌘⌥T |
Ctrl+Alt+T |
| New Task | ⌘↩ |
Ctrl+Enter |
| New Project | ⌘⌥↩ |
Ctrl+Alt+Enter |
| Search (item path) | ⌘⌥F |
Ctrl+Alt+F |
| Clear filter | Esc |
Esc |
| Go to Anything | ⌘⌥P |
Ctrl+Alt+P |
| Go Home | ⌘⌥H |
Ctrl+Alt+H |
| Indent / Outdent | Tab / ⇧Tab |
same |
More: Command Palette → type Tasky.
Archiving
- Mark tasks done (
⌘D/Ctrl+D) - Archive @done Items (
⌘⇧A/Ctrl+Shift+A) moves them underArchive:
The Activity Bar Tags list ignores items under Archive: (active tags only). Projects still lists Archive: so you can open history.
Settings: tasky.archive.*, tasky.includeDateWhenTaggingDone.
Search examples
//task
//not @done
project Inbox //task
@due
@today
Compatibility
Tasky files use the same plain-text conventions as TaskPaper. Files round-trip with TaskPaper for Mac and other TaskPaper-compatible tools.
Development
npm install
npm run compile
npm run unit
npm run package # → tasky-0.4.2.vsix
Credits
- TaskPaper format — Hog Bay Software
- birch-outline (MIT) — outline model
- vscode-codicons
License
MIT — see LICENSE.