whatisgithub

What is todo-tree-next?

real-elysia886/todo-tree-next — explained in plain English

Analysis updated 2026-05-18

64JavaScriptAudience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

A VS Code extension that finds, organizes, and prioritizes TODO comments across a codebase, with a fast Rust scanner and Git awareness.

Mindmap

mindmap
  root((repo))
    What it does
      Scans TODO comments
      Tracks priority and owner
      Shows dashboard charts
    Tech stack
      TypeScript
      Rust scanner
      VS Code API
    Use cases
      Track TODO debt
      Review before merge
      Feed AI coding tools
    Audience
      Developers
      Team leads

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Track and prioritize TODO and FIXME comments across a large codebase.

USE CASE 2

Generate a report of unresolved TODO debt on a branch before merging.

USE CASE 3

Feed structured TODO context into an AI coding assistant.

What is it built with?

JavaScriptTypeScriptRustVS Code

How does it compare?

real-elysia886/todo-tree-nextkiddo-pwn/ffffirefoxwordpress-gcb/gutenberg-control-blocks-lite
Stars646464
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyeasyhardmoderate
Complexity2/55/54/5
Audiencedeveloperresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Todo Tree Next is a VS Code extension that finds and organizes TODO comments, FIXME notes, and similar task markers scattered across your codebase. It is a rewrite of the original Todo Tree extension, rebuilt with TypeScript and a Rust based scanning engine so that searching large projects is faster. The extension scans your files for tags like TODO, FIXME, and BUG, as well as markdown style checklist items such as unchecked boxes. Each item can carry extra metadata, including a priority level, an assigned person, a due date, and labels, all written directly in the comment using a simple syntax. A dashboard view shows counts and charts of where these tasks are concentrated, and lets you switch between the Rust scanner and a ripgrep based fallback. There is also a smart filter system so you can search using structured queries, for example combining a tag, a file path, and a priority level in one search. The tool understands Git as well. You can scan only the files that changed or are staged for commit, and export a report showing how much unresolved TODO debt exists on a branch, which is useful for reviewing before a merge. A notable feature is its AI Agent interface. This lets AI coding tools read a structured, machine readable list of all the TODOs in a project, complete with file location, priority, and context, and then write suggested notes or warnings back into the editor. This is exposed both through VS Code's command system and through a command line tool. You install it by searching the VS Code Marketplace for the extension name, or by building and installing a package file offline. The project is written mostly in JavaScript and TypeScript for the extension itself, with a Rust component handling the fast scanning. It includes 135 automated tests, split between the extension and the scanner. It is released under the MIT license and is based on the original Todo Tree extension by Gruntfuggly.

Copy-paste prompts

Prompt 1
Help me set up Todo Tree Next and configure the scanner engine in VS Code settings.
Prompt 2
Show me how to write a smart filter query that finds P0 TODOs in the src folder.
Prompt 3
Explain how to call the getAgentContext command from an AI coding tool.
Prompt 4
Walk me through building the Rust scanner and running the test suite.

Frequently asked questions

What is todo-tree-next?

A VS Code extension that finds, organizes, and prioritizes TODO comments across a codebase, with a fast Rust scanner and Git awareness.

What language is todo-tree-next written in?

Mainly JavaScript. The stack also includes JavaScript, TypeScript, Rust.

What license does todo-tree-next use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is todo-tree-next to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is todo-tree-next for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.