用途
CodeGraph 面向 AI 编码代理，解决代理理解代码时的低效问题。传统方式下，代理需要逐文件反复执行 grep、glob、Read 等操作，手工重建调用路径和依赖关系，产生大量工具调用和往返。CodeGraph 提供预建的代码知识图谱，让代理通过一次查询直接获得所需源码、符号间的调用路径（包括 grep 无法追踪的动态分发跳转）以及改动的影响范围。
主要能力
- 预建知识图谱：包含代码库中的每个符号、调用边和依赖关系，代理只需一次调用即可获取精确上下文。
- 自动同步：默认启用自动同步，监视项目文件变化并更新图谱。文件保存后约 300ms 触发监视，只同步变更内容，不重新扫描整个目录树。
- 多代理支持：支持 Claude Code、Cursor、Codex CLI、opencode、Hermes Agent、Gemini CLI、Antigravity IDE、Kiro 和 GitHub Copilot（VS Code、Copilot CLI、JetBrains IDE），自动将 CodeGraph MCP 服务器接入各代理。
- 多语言支持：解析引擎为原生 Rust 内核，支持 20 种语言：TypeScript、JavaScript、Java、Python、Go、C、C++、Rust、C#、Ruby、PHP、Swift、Kotlin、Scala、Dart、R、Lua、Luau（Metal 和 CUDA 走 C++ 路径）。
- 框架路由识别：检测 Web 框架路由文件，生成路由节点并通过引用边链接到处理类或函数。查询视图/控制器的调用者时，可显示绑定它的 URL 模式。
- 移动端导航边：对 iOS/React Native 等框架，生成 navigates 边，将发送用户跳转的函数链接到目标界面。
- 100% 本地：所有处理在本地完成，不依赖云端服务。
使用方式
- 安装 CLI：一条命令自动为操作系统获取正确构建，无需 Node.js，安装器自带运行时。安装后需打开新终端使命令生效。可用
codegraph upgrade升级，--check检查更新，codegraph upgrade <version>固定版本。 - 接入代理：在新终端中运行安装器，自动检测并配置所支持的代理，将 CodeGraph MCP 服务器接入各代理。快捷方式：
npx @colbymchenry/codegraph。 - 初始化项目：运行
codegraph init创建本地.codegraph/目录并构建完整图谱。 - 自动同步：默认启用，无需手动操作。
- 卸载：一条命令可从所有已配置代理和 CLI 本身移除 CodeGraph。
--keep-cli仅移除代理配置，保留 CLI。
适用场景
适用于需要 AI 编码代理理解大型或跨文件代码库的场景，尤其是需要快速回答架构问题、追踪调用路径、评估改动影响范围时。在中小型代码库中也能提升精度，减少代理逐文件爬取的开销。
限制
- 对于长会话和小上下文窗口，CodeGraph 返回的密集载荷会占用更多常驻上下文。在 7 个仓库的多轮会话中，其响应在会话结束时留下的检索上下文比逐文件读取代理多约 80%。
- CodeGraph 仅在代理直接查询时有效，其指令引导代理直接回答，而非委托给读取文件的子代理，否则子代理仍会读取文件，CodeGraph 反而成为额外开销。
- 手动
codegraph sync仅在监视器被禁用（沙盒环境或CODEGRAPH_NO_DAEMON=1）或在代理会话外编写脚本时才有必要。 - 无预构建二进制的平台和存在语法错误的文件会按文件回退到参考引擎，图谱结果相同。
- 具体的收费、价格信息暂未提供。
