Houseofmvps/codesight

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

它解決了什麼問題

AI 助理常常因為必須手動探索程式碼庫以了解其結構、路由與 schema，浪費上千個 token 才能回答問題。codesight 透過將程式碼庫預先編譯成緊湊、AI 最佳化的上下文圖與知識庫，顯著減少 token 用量並提升回應的正確性。

它如何運作

此工具對 TypeScript 專案使用 AST（抽象語法樹）精確度，對其他支援語言則使用經過實戰驗證的正則表達式偵測。它會掃描專案根目錄，找出路由、schema 模型、UI 元件與相依圖，且不需要 API 金鑰或外部 LLM 呼叫。

它提供三層上下文：

  1. Base Scan：產生專案的編譯圖（例如 CODESIGHT.md）。
  2. Wiki Knowledge Base：生成永久且針對性的 markdown 文章集合（例如 auth.md、database.md），讓 AI 只閱讀相關段落，而非整張地圖。
  3. Knowledge Mode：將非程式碼文件（如 ADR、會議筆記、Obsidian vault）映射成 KNOWLEDGE.md 入門文件。

目標使用者

使用 Claude Code、Cursor、GitHub Copilot、Windsurf、Cline 或 Aider 等 AI 程式碼助理的開發者，想要降低 token 成本並加速 AI 對專案的理解。

重點特色

  • Zero Dependencies：只需一次 npx 呼叫，無需任何設定或 API 金鑰。
  • 廣泛語言支援：支援 TypeScript、JavaScript、Python、Go、Ruby、Elixir、Java、Kotlin、Rust、PHP、Dart、Swift 與 C#。
  • 高 Token 效率：基準測試顯示相較於手動 AI 探索，可減少高達 91 倍的 token 使用。
  • MCP 整合：內建 14 個 MCP 工具，讓 Claude Code 等助理能以程式方式存取專案圖與維基。
  • Blast Radius 分析：當特定檔案變更時，可辨識所有受影響的檔案、路由與模型。