tododebt

tododebt

コードベースには、どのくらいの認識済みの技術的負債が残っているでしょうか？ tododebt は、ソースファイル群に含まれるマーカー（デフォルトでは TODO、FIXME、HACK）を一覧化し、各出現箇所のファイル、1 始まりの行番号、行のテキストとともに、合計数、マーカー別の数、ファイル別の数を報告します。

マーカーとして数えられるのは、単独のトークンとして現れる場合のみです（マーカーの後ろに文字以外が続く場合）。そのため、TODOS や METHOD が誤検出されることはなく、TODO:、FIXME(user)、// TODO はすべて数えられます。1 行につき、最初のマーカーのみが報告されます。大文字と小文字は区別されます。

MCP ツールはファイル内容を入力として受け取ります（ディスクにはアクセスしません）。CLI は指定したファイルを読み取ります。完全にローカルで処理され、ネットワークも設定も必要ありません。

CLI

npx @reneturcios/tododebt scan src/*.ts
npx @reneturcios/tododebt scan README.md src/index.ts --markers TODO,XXX
npx @reneturcios/tododebt --version

終了コード：成功時は 0（結果が 1 件以上あってもエラーではありません）、実行時エラー時（読み取り不可のファイルを含む）は 1、使用方法のエラー時は 2 です。

MCP サーバー

npx -y @reneturcios/tododebt mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "tododebt": {
      "command": "npx",
      "args": ["-y", "@reneturcios/tododebt", "mcp"]
    }
  }
}

ツール

• scan_todos — 指定されたソースファイル全体から、技術的負債を示すマーカーを一覧化します。
  • files（配列、必須）— スキャンするファイルを {path, content} のペアで指定します
  • markers（文字列の配列、任意）— 検索するマーカー。デフォルトは TODO、FIXME、HACK です

Docker

docker run -i ghcr.io/cloudcorprecords/tododebt
docker run --rm -v "$PWD:/w" ghcr.io/cloudcorprecords/tododebt scan /w/src/index.ts

開発

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (pure local, no network)
npm run dev     # run the CLI from source

ライセンス

MIT — Copyright (c) 2026 Rene Turcios