TODOseq

approved

by Stephen Cross

Lightweight keyword-based task tracker using Logseq style keywords.

66 stars6,197 downloadsUpdated 13d agoMIT

TODOseq for Obsidian

Obsidian Downloads GitHub Release License

Keyword-based task management for Obsidian. No checkboxes required.

TODOseq ("to-do-seek") scans your vault for plain lines that start with TODO, DOING, and DONE, then collects them into one Task List. Keep writing in ordinary notes — inspired by Emacs Org-mode and Logseq. Free and open source (MIT).

Install from Community Plugins · Documentation · Report an issue

Click a TODO keyword in Obsidian to cycle its task state

Why TODOseq?

Most task managers force you into a separate system. TODOseq meets you where you already work — inside your Obsidian notes. Type TODO Write report anywhere, and it appears in the Task List. No second app, no checkbox ceremony.

  • Plain keywords instead of - [ ] checkbox syntax
  • Logseq / Org-mode compatible, including natural-language dates
  • Vault-wide Task List: search, urgency, priorities, embedded lists

What you get

  • Keywords TODO / DOING / DONE / … with [#A] priorities
  • Natural language dates converted to structured Org dates
  • Unified Task List with filters, urgency sort, and advanced queries
  • Works in Edit and Reading views; click a keyword or Ctrl+Enter
  • Code-comment TODOs in 20+ languages
  • todoseq embedded lists in notes
  • Subtasks, repeating tasks, optional CLOSED dates
  • Logseq-compatible format for dual-use vaults

More detail in the documentation.

Quick start

  1. Install: Settings → Community plugins → Browse → search TODOseq → Install → Enable
  2. Type a task in any note:
TODO [#A] Finish quarterly report #work tomorrow
DOING Review pull requests #coding
DONE Submit expense report
  1. Open the Task List — right sidebar, or Command Palette → “TODOseq: Show task list”

Documentation

Full guides: scross01.github.io/obsidian-todoseq

Start here:

Development

Requires Node.js 20+.

CommandPurpose
npm installInstall dependencies
npm run devesbuild watch mode
npm run buildTypecheck + production bundle
npm testUnit tests
npm run lint / npm run formatESLint / Prettier
npm run docs:devVitePress docs dev server

Integration tests, CDP debugging, and PR expectations: see CONTRIBUTING.md and AGENTS.md.

Contributing

Issues and pull requests are welcome. See CONTRIBUTING.md.

  • Report issues or request features
  • Star the repo if TODOseq is useful to you

License

MIT — see LICENSE.

For plugin developers

Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.