colbymchenry/codegraph
CodeGraph 是一个为 AI 编码代理(Claude Code、Cursor、Codex、Gemini、Copilot 等)预构建的本地代码知识图谱,自动同步代码变更,通过语义检索一次性提供精准上下文,减少 token 消耗与工具调用次数,核心解析引擎由 Rust 编写。
CodeGraph(colbymchenry/codegraph,C 为主,72532 Stars)是面向 AI 编码代理(Claude Code、Cursor、Codex、Gemini、Copilot 等)预构建的本地代码知识图谱,自动同步代码变更,通过语义检索一次性提供精准上下文,减少 token 消耗与工具调用次数;解析引擎为编译型 Rust 内核,支持 20+ 语言(TypeScript、JavaScript、Java、Python、Go、C、C++、Rust、C#、Ruby、PHP、Swift、Kotlin、Scala、Dart、R、Lua、Luau、ArkTS、VB.NET、COBOL、Objective-C、Svelte、Vue、Astro、Liquid、Pascal/Delphi、Erlang、Solidity、Terraform/OpenTofu、Nix、CFML 等),每文件一次边界跨越,所有语言上线前验证其生成的图与参考引擎在真实仓库(从小的库到 Linux 内核)逐字节完全一致;根据实际硬件(真实核心数、容器/cgroup 感知、可用内存、项目解析成本)自适应调整工作池、并行解析与分析缓存,Linux 内核(70k 文件、2M 符号、6.4M 关系)12 分钟完成索引,Swift 编译器仓库(27k 文件)全新索引约 100 秒、单文件编辑重同步约 4 秒;文件监视器基于原生 OS 事件(FSEvents/inotify/ReadDirectoryChangesW)带防抖,保存后 300ms 触发增量同步,4,400 文件项目约 0.3 秒,27,000 文件 Swift 编译器仓库约 0.4 秒,在 31 仓库、30 语言基准测试中中大型仓库快 2–7 倍;关键特性含精准上下文(一次工具调用返回入口点、符号与片段)、基于 FTS5 的全文搜索、影响分析(调用者/被调用者与完整影响半径)、始终最新、20+ 语言支持;2026-08-05 在 Claude Opus 4.8 上对 7 个真实开源代码库基准测试显示工具调用减少 88%、速度提升 53%、token 减少 62%、成本降低 44%、文件读取全部降至 0,但会话结束时残留检索上下文比文件读取代理多约 80%(VS Code 上 67k vs 18k token);安装无需 Node.js(curl/irm 脚本或 npm i -g @colbymchenry/codegraph),codegraph install 自动接入 Claude Code、Cursor、Codex CLI、opencode、Hermes Agent、Gemini CLI、Antigravity IDE、Kiro、GitHub Copilot,codegraph init 构建本地 .codegraph/ 目录,默认自动同步,MIT 许可,支持 Windows/macOS/Linux 与 MCP 工具 codegraph_explore。
CodeGraph 是一个为 AI 编码代理(Claude Code、Cursor、Codex、Gemini、Copilot 等)预构建的本地代码知识图谱,自动同步代码变更,通过语义检索一次性提供精准上下文,减少 token 消耗与工具调用次数,核心解析引擎由 Rust 编写。