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