A faster, smarter TODO tree for VS Code, rebuilt with TypeScript, Rust, Git awareness, and AI Agent context.

English · 中文 · AI Agent Interface · Benchmarks

Todo Tree_Next keeps the familiar Todo Tree workflow, then turns it into a modern project-maintenance surface:

• Find TODO, FIXME, BUG, markdown tasks, and custom tags across large workspaces.
• Scan quickly with a native Rust engine while keeping ripgrep as a fallback.
• See priority, ownership, labels, due dates, Git status, and branch-level TODO debt.
• Use the dashboard to understand where work is concentrated.
• Give AI coding tools structured TODO context and let them annotate findings back into VS Code.

1. Download or build a .vsix.
2. Open the VS Code Extensions view.
3. Choose ... > Install from VSIX....
4. Select the generated package.

Todo Tree: Refresh
Todo Tree: Open Dashboard
Todo Tree: Scan Changed Files
Todo Tree: Scan Staged Files
Todo Tree: Export TODO Debt Report
Todo Tree: Get Agent TODO Context
Todo Tree: Clear Agent Annotations

Mix plain text with structured fields:

auth
tag:TODO
path:src
file:README.md
text:refactor
priority:P0
status:open
tag:FIXME path:src priority:P1

// TODO:P0 fix auth bug @alice due:2026-06-01 #security
// FIXME:P1 memory leak @bob #backend
// TODO! urgent task      -> P0
// TODO? needs discussion -> P2

The scanner turns these hints into structured data used by the tree, dashboard, exports, Git reports, and AI Agent interface.

Todo Tree: Open Dashboard gives you a compact control center:

• tag and priority distribution
• TODO trend chart
• scanner engine switch: auto, rust, ripgrep
• scan mode controls
• smart filter input
• changed/staged scan shortcuts

Git-focused commands help review TODO debt before merge:

Todo Tree: Scan Changed Files
Todo Tree: Scan Staged Files
Todo Tree: Export TODO Debt Report

Todo Tree_Next exposes TODO debt as a machine-readable project index. AI coding tools can read ranked TODO context, then write temporary editor diagnostics as review notes or suggested actions.

VS Code command API:

const context = await vscode.commands.executeCommand('todo-tree.getAgentContext');

await vscode.commands.executeCommand('todo-tree.annotateAgentFinding', {
  file: 'src/auth.ts',
  line: 42,
  column: 5,
  severity: 'warning',
  message: 'P0 TODO touches authentication code; review before merge.'
});

await vscode.commands.executeCommand('todo-tree.clearAgentAnnotations');

CLI:

todo-scanner agent-context --root . --config todo-scanner-config.json

Agent context includes file path, line/column, tag, priority, assignee, due date, labels, Git status, approximate age, code snippet, recommended action, and recommended order.

Full schema: docs/AGENT_INTERFACE.md

The MCP (Model Context Protocol) server is published independently from the VS Code extension as @real-elysia886/todo-tree-mcp. This keeps the VSIX small and lets CLI tools use TODO intelligence without depending on a VS Code installation.

// .claude/settings.json
{
  "mcpServers": {
    "todo-tree": {
      "command": "npx",
      "args": ["@real-elysia886/todo-tree-mcp", "path/to/workspace"],
      "env": {
        "TODO_TREE_SCANNER_PATH": "path/to/todo-scanner"
      }
    }
  }
}

Or run directly:

TODO_TREE_SCANNER_PATH=path/to/todo-scanner npx @real-elysia886/todo-tree-mcp path/to/workspace

The MCP server reads configuration from (in priority order):

1. Environment variables: TODO_TREE_SCANNER_PATH, TODO_TREE_TAGS, TODO_TREE_EXCLUDE_GLOBS
2. Config file: .todo-tree/config.json in workspace root
3. Defaults matching the VS Code extension

MCP server (standalone, no VS Code required)
  mcp/src/index.ts      MCP server entry point (stdio transport)
  mcp/src/scanner.ts    Rust CLI subprocess adapter
  mcp/src/config.ts     Configuration from env/file/defaults
  mcp/src/annotations.ts  JSON file-based annotation storage
  mcp/src/debtReport.ts Git TODO debt report
  mcp/src/filterQuery.ts  Structured filter parser
  mcp/src/watcher.ts    File watching + MCP resource notifications

VS Code extension
  extension.ts          entry point and legacy glue
  scannerClient.ts      Rust CLI JSON protocol
  agentInterface.ts     AI Agent context and diagnostics
  dashboard.ts          Webview dashboard
  tree.ts               Tree data provider
  filterQuery.ts        Structured filter parser
  gitScanner.ts         Git changed/staged scan
  debtReport.ts         Git TODO debt report
  constants.ts          Shared constants (scan modes, status bar, buttons)
  globUtils.ts          Glob building utilities for ripgrep
  config.ts             Configuration reader with caching layer
  searchResults.ts      Map-indexed search result store

Rust scanner
  main.rs               scan-workspace, scan-file, agent-context, benchmark
  walker.rs             .gitignore-aware traversal
  matcher.rs            TODO matching and metadata extraction
  output.rs             JSON output schema

npm install
npm run scanner:build
npm run webpack
npm test
npm run lint:check
npm run format:check
npm run test:coverage
cargo test --manifest-path scanner/Cargo.toml

# MCP server
cd mcp && npm install && npm run build && npm test

Package:

npm run vscode:prepublish
npx --yes @vscode/vsce package

Test coverage:

{
  "todo-tree.scanner.engine": "auto",
  "todo-tree.scanner.path": "",
  "todo-tree.scanner.maxFileSize": 1048576
}

• Rewrite notes
• Feature compatibility
• AI Agent interface
• Benchmark report

MIT. Based on the original Todo Tree extension by Gruntfuggly.