io.github.CloudCorpRecords由 GitHub 账号 CloudCorpRecords 发布v0.1.0更新于 Nov 6, 2026
TODO, FIXME, and HACK inventory with git blame age and file owner.
扫描传入的源码文件中的 TODO、FIXME、HACK、XXX 标记，逐条报告文件、行号与文本，并给出统计。
Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。
参照 仓库 中的启动说明。
How much acknowledged debt is sitting in the codebase?
tododebt inventories the markers — TODO, FIXME, HACK by
default — across a set of source files and reports every
occurrence with its file, 1-based line number, and line text,
plus counts in total, by marker, and by file.
A marker counts only as a standalone token (the marker followed
by a non-letter), so TODOS and METHOD never false-positive,
while TODO:, FIXME(user), and // TODO all count. Only the
first marker on a line is reported. Matching is case-sensitive.
The MCP tool takes file contents as input (no disk access); the CLI reads the files you name. Pure local computation: no network, no configuration.
Exit codes: 0 on success (a non-empty inventory is a result,
not an error), 1 on a runtime error (including an unreadable
file), 2 on a usage error.
MCP client config:
scan_todos — Inventory debt markers across supplied source
files.
files (array, required) — the files to scan, as
{path, content} pairsmarkers (array of strings, optional) — markers to look
for; default TODO, FIXME, HACKMIT — Copyright (c) 2026 Rene Turcios
来源：README.md，提交 9db7f97
Scan a repo for TODO, FIXME, HACK, and XXX markers in source files: each finding carries file, line, marker, and text; counts are grouped by marker and by file; when git history is available, blame dates the oldest markers. Verdict NONE when the tree is clean, DEBT otherwise.
path必填已满足适用检查项的 90%
该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。
请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。
npx @reneturcios/tododebt scan src/*.tsnpx @reneturcios/tododebt scan README.md src/index.ts --markers TODO,XXXnpx @reneturcios/tododebt --versionnpx -y @reneturcios/tododebt mcp{ "mcpServers": { "tododebt": { "command": "npx", "args": ["-y", "@reneturcios/tododebt", "mcp"] } }}docker run -i ghcr.io/cloudcorprecords/tododebtdocker run --rm -v "$PWD:/w" ghcr.io/cloudcorprecords/tododebt scan /w/src/index.tsnpm installnpm run build # tsc -> dist/npm test # tsx --test test/*.test.ts (pure local, no network)npm run dev # run the CLI from source