Houseofmvps/codesight

Universal AI context generator. Saves thousands of tokens per conversation in Claude Code, Cursor, Copilot, Codex, and more.

解決する課題

AI アシスタントは、コードベースの構造、ルート、スキーマを手動で探索して理解するのに何千ものトークンを浪費しがちです。codesight はコードベースをコンパクトな AI 最適化コンテキストマップとナレッジベースに事前コンパイルすることで、このオーバーヘッドを削減し、トークン使用量を大幅に減らし、応答精度を向上させます。

仕組み

このツールは TypeScript プロジェクトに対しては AST（抽象構文木）を用いた高精度解析を、その他のサポート言語に対しては実績のある正規表現検出を使用します。プロジェクトのルートをスキャンし、ルート、スキーマモデル、UI コンポーネント、依存関係グラフを特定します。API キーや外部 LLM 呼び出しは不要です。

コンテキストは 3 層で提供されます：

  1. Base Scan：プロジェクトのコンパイルマップを作成（例：CODESIGHT.md）。
  2. Wiki Knowledge Base：永続的でターゲットを絞った Markdown 記事のセットを生成（例：auth.md、database.md）。AI は全体マップではなく関連セクションだけを読むことができます。
  3. Knowledge Mode：ADRs、会議ノート、Obsidian ボールトなどの非コードドキュメントを KNOWLEDGE.md プライマーにマッピングします。

対象ユーザー

Claude Code、Cursor、GitHub Copilot、Windsurf、Cline、Aider などの AI コーディングアシスタントを利用し、トークンコストを削減しプロジェクト理解を加速したい開発者向けです。

ハイライト

  • Zero Dependencies：設定や API キー不要で、npx の一回呼び出しだけで動作します。
  • 広範な言語サポート：TypeScript、JavaScript、Python、Go、Ruby、Elixir、Java、Kotlin、Rust、PHP、Dart、Swift、C# をサポート。
  • 高いトークン効率：ベンチマークでは手動 AI 探索に比べて最大 91 倍のトークン削減が確認されています。
  • MCP 統合：14 の MCP ツールを含み、Claude Code などのアシスタントがプログラム的にプロジェクトマップとウィキにアクセス可能。
  • Blast Radius 分析：特定ファイルが変更された際に、影響を受けるすべてのファイル、ルート、モデルを特定できます。