abhigyanpatwari/GitNexus
开发工具把代码库索引成可查询的知识图谱,让编程 Agent 和编辑器通过 MCP 查找调用、依赖和影响范围。
GitNexus
项目介绍
GitNexus 把仓库解析成由符号、调用、依赖和执行流组成的图谱。索引在本地完成,CLI 本身不调用大模型,因此核心分析不需要 API Key。编程 Agent 通过 MCP 工具访问这张图,开发者也可以用命令行或网页图谱浏览器查看。它适合希望助手基于一份持久索引回答「谁调用了这个函数」「这次改动会影响什么」的团队,而不是每次都重新读文件。
同一份索引支撑多种操作:用 query 搜索代码和执行流,用 context 查看符号的调用方与依赖,用 impact 评估改动影响面,用 trace 追踪两个符号之间的路径,用 detect_changes 审查 Git diff 的影响,用 rename 预览并执行语义重命名。
快速使用
需要 Node.js 22.18+(22.x 系列)或 24.11+。在要索引的仓库根目录执行:
npx gitnexus analyze
npx gitnexus setup
analyze 会构建索引,同时安装 Agent 技能、注册 Claude Code hooks,并写入 AGENTS.md / CLAUDE.md。如果只想生成索引、不改动这些仓库文件,使用 gitnexus analyze --index-only。setup 为受支持的编辑器配置 MCP;可以指定编辑器,例如 gitnexus setup -c cursor,codex。Windsurf 需要手动配置 MCP,支持矩阵和手动步骤见编辑器配置文档。
索引完成后,常用命令包括 gitnexus status 查看索引是否过期、gitnexus query "authentication" 搜索图谱、gitnexus impact UserService --direction upstream 查看上游影响。多客户端并发时,用 gitnexus mcp --http --port 3111 启动一个共享服务,让客户端连接 http://127.0.0.1:3111/mcp,而不是给每个客户端单独开 stdio。
想可视化浏览,运行 gitnexus serve 后打开网页 UI,它直接使用现有索引,不需要重新上传或重新索引。命令和参数的完整说明见 CLI 参考。
支持语言
已注册的 provider 覆盖 C、C++、C#、COBOL、Dart、Go、Java、JavaScript、Kotlin、Objective-C、PHP、Python、Ruby、Rust、Swift、TypeScript、Vue 和 Zig。不同语法结构的支持程度不同,语言清单记录了实测行为、排除项和剩余缺口。解析质量还取决于可用的代码证据,因此应预期助手会报告歧义、索引新鲜度和覆盖范围的限制,而不是给出确定结论。
使用约束
- 开源版本采用 PolyForm Noncommercial 1.0.0 许可,商业使用需要单独授权;企业版 SaaS 或自托管版本提供 PR 审查、多仓库统一图谱和 OCaml 支持等能力。
- CLI 索引器在本地运行且不使用大模型。可选的远程向量嵌入、Wiki 生成和 AI 对话会使用你配置的服务商,只有通过这些服务时数据才会离开本机。
- 如果通过网页 UI 或托管部署把索引开放给其他用户,请先阅读安全说明和部署鉴权部分;Docker 与托管部署步骤见部署文档。
- Linux 和 Windows 的原生依赖单独列在平台要求中,安装问题见故障排查文档。
HotRepo 点评
GitNexus 出现在 HotRepo 2026 年 8 月 28 日至 31 日的全部语言日榜快照中,Stars 从 46,074 涨到 46,714,单日新增在 181 到 273 之间。它没有已记录的全部语言日榜名次,现有记录也只是四天的短窗口,因此只能支持「这几天持续增长」这一观察。更有参考价值的是产品形态:离线本地索引、MCP 集成、浏览器图谱浏览,再加上面向 PR 影响面分析和多仓库图谱的付费企业版。这套组合面向已经在使用编程 Agent、需要跨仓库上下文的团队;规模较小或只涉及单一语言的项目,获得的收益可能不如接入成本明显。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。