Skip to content
| Marketplace
Sign in
Visual Studio Code>Linters>Todoscope: TODO List, Highlights & ReportsNew to Visual Studio Code? Get it now.
Todoscope: TODO List, Highlights & Reports

Todoscope: TODO List, Highlights & Reports

Myzles

|
1 install
| (0) | Free
Find every TODO, FIXME, BUG and HACK in your workspace. Fast tree view and highlights with a built-in scanner: no ripgrep, no setup. Imports Todo Tree settings. Free; Pro $12/year or $29 once.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

Todoscope

Every TODO, FIXME, BUG and HACK in your workspace, in one fast tree, with highlights in the editor.

Free. Pro is $12 a year or $29 once, with a 7-day Pro trial, no card needed. Licences are per person: one key covers all of your own machines and editors.

Todoscope has its own scanner built in. There is no ripgrep binary to find, so nothing breaks when VS Code updates, and it works the same in VS Code, Cursor, Windsurf and VSCodium, locally or over Remote SSH, WSL, Dev Containers and Codespaces.

Todoscope tree and highlights

Switching from another TODO extension

Run Todoscope: Import Todo Tree Settings (it is also offered on first start). It tells you exactly what it copied.

Carries over: your tags, colours, include and exclude globs, case setting and custom regex. A custom regex that uses $TAGS works unchanged.

Does not carry over: keybindings and named scopes. Set those up again if you used them.

Then disable Todo Tree, so you don't see every TODO twice.

What you gain: no ripgrep to install or break after a VS Code update, and the TODOs you added on your current branch (Pro).

Free features

  • Workspace tree of every tagged comment, grouped by file, folder tree or tag. Click to jump to the line.
  • Editor highlights for each tag in its own colour, plus marks in the scroll bar. Highlight just the tag or the whole line.
  • Live updates: the tree changes as you type, save, create or delete files, and switch branches.
  • Comment-aware matching for 40+ languages: //, #, /* */, <!-- -->, --, ;, %, ', REM, docstrings, JSDoc, JSX and Markdown lists. const status = 'TODO' and TODOS are not counted.
  • Respects .gitignore (nested files and ! rules) and skips node_modules, build output, lock files, minified files and binaries automatically.
  • Filters: by text, by tag, with one-click clear. The status bar shows the count.
  • Next / previous TODO: Alt+Shift+] and Alt+Shift+[ across the whole workspace.
  • Your own tags and colours, case-sensitive or not, or your own regex.
  • Fast on big repos: the VS Code source tree (21,000 files) scans in about 1.5 seconds. After that, only changed files are rescanned.

Pro features

Pro: TODOs added on this branch, with author and age

  • TODOs added on this branch: show only the TODOs you added on this branch compared with main (or any branch, tag or commit), including work you haven't committed yet. Good for reviewing your own PR before you push.
  • Who and when: author and age of every TODO from git blame, in the tree and tooltip.
  • Stale TODOs: list the ones older than N days (180 by default).
  • Due dates, assignees and priority: write TODO(@sam, 2027-01-15): migrate and Todoscope marks it overdue when the date passes, and can group the tree by assignee. @due(2027-01-15), !high and (p1) also work.
  • Reports: export what the tree shows to Markdown (a checklist for a PR, standup or tech-debt review), CSV or JSON.

Try every Pro feature free for 7 days, no key or card needed: run any Pro command and choose Start 7-Day Free Trial.

Price
Pro Yearly $12 / year
Pro Lifetime $29 once

One license key works on all of your machines and editors. Buy with Todoscope: Get Todoscope Pro, then run Todoscope: Enter Pro License Key. The key is checked once a week and keeps working offline for up to three weeks.

Commands

Command
Todoscope: Show TODO List Open the tree
Todoscope: Go to Next / Previous TODO Alt+Shift+] / Alt+Shift+[
Todoscope: Filter by Text / Filter by Tag / Clear Filters Narrow the tree
Todoscope: Group By… File, folder tree, tag, assignee (Pro)
Todoscope: Rescan Workspace Full rescan
Todoscope: Import Todo Tree Settings Move your setup over
Todoscope: Show TODOs Added Since Branch… Pro
Todoscope: Toggle Stale TODOs Only Pro
Todoscope: Toggle Overdue TODOs Only Pro
Todoscope: Export TODO Report… Pro

Settings

Setting Default
todoLens.tags TODO FIXME BUG HACK XXX Tags to find
todoLens.caseSensitive true TODO but not todo
todoLens.highlights built-in colours {"TODO": {"foreground": "#000", "background": "#FFB000"}}
todoLens.highlightStyle tag tag, line or none
todoLens.exclude [] Extra paths to skip (dist/, **/generated/**)
todoLens.include [] Only scan these (src/, *.py)
todoLens.useGitignore true Skip files in .gitignore
todoLens.maxFileSizeKB 1024 Skip larger files
todoLens.scope workspace workspace, openFiles or currentFile
todoLens.gutterIcons false Coloured dot in the gutter on each TODO line
todoLens.groupBy file file, folder, tag, assignee
todoLens.customRegex empty Your own regex with $TAGS
todoLens.staleDays 180 Pro: age that counts as stale

Privacy

Todoscope reads your files locally and sends nothing anywhere. The only network call is the weekly license check for Pro users, which sends the license key to Polar (the store that sells it) and nothing else. Git features run your local git and are turned off in untrusted workspaces.

Support

Questions, bugs and ideas: open an issue. Billing and keys: the link in your Polar receipt.

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft