colbymchenry/codegraph

项目概览

值得关注的是，它把结构化代码检索、文件变更同步和受影响测试追踪放在同一工作流中：代理可通过一次工具调用获取入口、相关符号和代码片段，开发者也可通过导入依赖追踪变更涉及的测试文件。

项目类型

MCP · AI 编程 · AI 搜索

应用场景

编程开发

部署方式

查看项目说明

License

MIT

适合谁

• 使用受支持编码代理、愿意完成命令行配置，并能确认代理直接调用图谱工具的开发者。
• 希望在本地建立项目结构索引，并查询符号、调用关系、依赖及相关源码的开发者。
• 需要按导入依赖查找变更相关测试，或需要将图谱接口嵌入应用的开发者。

核心能力

• 已提供。通过 codegraph init 为项目建立符号、调用边和依赖图谱，并写入本地 .codegraph/ 目录，为后续结构化代码查询准备索引。
• 已提供。监听项目中的文件变化并更新图谱，使持续编辑过程中的代码变更进入索引维护流程。
• 已提供。通过 codegraph install 将 MCP 服务接入支持的编码代理，让这些外部代理能够调用代码图谱工具；代理本身不是项目提供的能力。
• 已提供。一次工具调用返回入口、相关符号和代码片段，使代理可以围绕这些结果开展任务，而不必仅依赖逐文件探索。
• 已提供。使用 FTS5 支持跨代码库的按名称搜索，为已知名称的代码定位提供查询入口；这里不将全文搜索解释为语义搜索。
• 已提供。codegraph affected 从变更源码出发，沿导入依赖进行传递追踪，找出相关测试文件，供开发者判断需要关注的测试范围。
• 已提供。npm 包重新导出可编程调用的 CodeGraph 类，可用于在应用中嵌入图谱能力，例如在 Electron 主进程中使用，而不只通过命令行交互。

限制与风险

• 项目资料明确指出，只有直接查询图谱时才有帮助；若子代理仍通过读取文件探索代码，图谱会带来额外开销。
• 采用流程包含安装命令行工具、接入代理、逐项目初始化和代理重启，不适合拒绝终端操作的用户。
• 项目给出的七个代码库基准报告了工具调用减少 88%、速度提高 53%、令牌减少 62% 和费用减少 44%。这些是项目报告的基准结果，不应直接作为其他代码库或代理工作流的结果承诺。
• 结构化资料将数据边界标记为未记录、且未说明遥测行为；项目使用不要求付费服务，但数据边界声明的端到端核实信息未随资料提供，涉及敏感代码时建议在实际环境中自行确认。
• 提供的资料未记录 GPU 要求；资源适配说明不能替代对具体环境要求的确认。

如何开始

• 通过安装脚本或 npm 安装命令行工具。上手需要终端操作，资料将配置难度标为中等。
• 运行 codegraph install 配置代理接入，然后在需要索引的项目目录运行 codegraph init。初始化是按项目进行的，索引保存在该项目的 .codegraph/ 目录中。
• 配置完成后重启代理，并检查它是否直接调用图谱工具获取上下文；仅完成安装，不足以确认代理工作流已使用图谱。

核验依据

• README: 100% Local | No data leaves your machine. No API keys. No external services. SQLite database only
• README: curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh
• README: npm i -g @colbymchenry/codegraph
• README: Detects and auto-configures Claude Code, Cursor, Codex CLI, opencode, Hermes Agent, Gemini CLI, Antigravity IDE, Kiro, and GitHub Copilot (VS Code, Copilot CLI, JetBrains IDEs) —…
• README: `codegraph init` creates the local `.codegraph/` directory and builds the full graph in the same step — one command, done.

来源更新时间：2026-10-04T18:33:53Z

打开原始 GitHub 项目