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 分析：当特定文件更改时，可识别所有受影响的文件、路由和模型。