Codesight CLIは、コードベースをスキャンすることでAIコーディングエージェントのトークン使用量を削減します。

Codesightの機能

Codesightはコードベースをスキャンし、AIアシスタント向けのコンパクトなコンテキストパックを.codesight/ディレクトリに生成するCLIツールです。これにより、Claude CodeのようなAIコーディングエージェントが各会話の開始時に同じファイルを繰り返し探索することを防ぎます。通常、実際の作業が始まる前に25K〜60Kトークンが消費されます。

仕組み

リポジトリのルートでnpx codesightを実行します。このツールは正規表現ではなくAST/構造化解析を使用して、TypeScript（Next.js、Express、Fastify、Hono、Nest、tRPC、React）、Python（FastAPI、Django、SQLAlchemy）、Go（Gin、Gorm）スタックをスキャンします。以下のファイルを生成します：

• CODESIGHT.md – アーキテクチャと主要エントリーポイントの1〜2kトークンの概要
• routes.md – メソッド、パス、タグを含むすべてのAPIルート
• schema.md – 主要フィールドとリレーションを含むデータベースモデル
• components.md – UIコンポーネントとプロパティ
• env.md – 使用場所とデフォルト値の欠落を含む環境変数
• graph.md – 「ホット」ファイルと影響範囲分析を含むインポートグラフ

影響範囲分析はインポートグラフをたどり、特定のファイルに依存するファイル、ルート、モデルを正確に表示し、「これを変更すると何が壊れるか？」という質問に答えるのに役立ちます。

統合

CLAUDE.mdに1行追加して、Claudeにツリーを探索する前に.codesight/CODESIGHT.mdと関連ファイルを読むように指示します。このツールにはMCPサーバーとClaude Code、Cursor、Codex、Copilot向けの既製プロファイルが付属しており、これらのツールは.codesightを高優先度のコンテキストとして扱います。

ベンチマーク

実際のプロダクションコードベースからのバージョン1.3.1のベンチマーク：

• SaveMRR（Hono + Drizzle、4ワークスペース、92ファイル）：5,129出力トークン vs 66,040推定探索トークン（12.9倍削減）
• BuildRadar（raw HTTP + Drizzle、53ファイル）：3,945出力トークン vs 46,020推定探索トークン（11.7倍削減）
• 全体平均：約12.3倍のトークン削減

TypeScript/Nextバックエンドでは、長い「理解＋機能追加＋差分レビュー」セッションで、ClaudeがCodesightファイルを読むことで、ツリーを探索する場合に比べて40〜50Kトークンの探索が回避されました。

技術詳細

ランタイム依存関係なしの単一npxバイナリ。MITライセンス。https://github.com/Houseofmvps/codesightでGitHubで利用可能。