更快更智能的 VS Code TODO 树插件，TypeScript + Rust 重写，带优先级、标签、Git 感知和 AI Agent 接口。

https://github.com/real-Elysia886/Todo-Tree-Next…

Todo-Tree-Next 是对经典 Todo Tree 的现代化重写，用 TypeScript 和 Rust 双引擎实现。核心功能有：Rust 原生扫描器（可回退 ripgrep）、文件级增量刷新、TODO 元数据（P0-P3、@负责人、due 日期、#标签）、智能过滤、Markdown 任务支持。

real-Elysia886/Todo-Tree-Next

Source: https://github.com/real-Elysia886/Todo-Tree-Next

Todo Tree_Next

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

English · 中文 · AI Agent Interface · Benchmarks

Why Todo Tree_Next

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.

Feature Snapshot

Install

Search the VS Code Marketplace for:

Todo Tree_Next

Offline install:

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

Everyday Commands

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

Smart Filtering

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

Priority And Metadata

// 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.

Dashboard And Git

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

AI Agent Interface

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

Architecture

VS Code extension
  extension.js          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

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

Develop And Package

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

Package:

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

Test coverage:

Configuration

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

More Documentation

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

License

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