一、什么是 GitNexus？

GitNexus 是一款专门为 AI Agent（AI 智能体） 设计的代码库智能分析引擎。

它并不像 CodeGraph 那样主要关注代码索引速度或Token 成本优化，而是致力于为 AI 构建一张完整、准确的代码知识地图（Knowledge Graph）。

想象一下，一个大型项目中往往有数千个类、方法和模块，它们之间存在复杂的调用关系。

当你向 AI 提出类似的问题：

• 修改这个方法会影响哪些地方？

• 这个接口的调用链是什么？

• 这个模块依赖哪些服务？

• 这段代码真正属于哪个业务流程？

普通 AI 往往只能依赖上下文进行推测，因此容易遗漏影响范围。

而 GitNexus 会提前分析整个项目，为代码建立完整的知识图谱，包括：

• 节点（Node）

• 调用关系（Relationship）

• 功能聚类（Clusters）

• 执行流程（Processes）

因此 AI 可以基于这些预计算的数据进行推理，而不是依靠猜测，大幅提升回答的准确性和可靠性。

---

二、安装 GitNexus

GitNexus 提供两种使用方式：

• 本地分析（推荐）

• 快速体验

日常开发建议使用本地分析模式。

它会在本地生成索引，并与 Cursor、Claude Code 等 AI 编辑器无缝协同，不受网络或项目规模限制。

环境要求

安装前请确认：

• Node.js 18 或以上版本

• npm（Node.js 自带）

可以执行：

node --version

查看当前 Node 版本。

---

安装

执行：

npm install -g @veewo/gitnexus

注意：官方包名是 @veewo/gitnexus，不是 gitnexus。

安装完成后执行：

gitnexus --version

如果能够正确输出版本号，则说明安装成功。

---

三、分析你的项目

安装完成后，需要先对项目建立索引。

进入项目根目录：

cd your-project

执行：

gitnexus analyze

GitNexus 会自动分析整个代码库，并建立知识图谱。

同时生成 AI Agent 所需的上下文文件，例如：

• AGENTS.md

• CLAUDE.md

之后 Cursor、Claude Code 等工具即可利用这些信息，更准确地理解整个项目。

---

增量更新

项目代码发生变化后，无需重新全量分析。

只需要再次执行：

gitnexus analyze

GitNexus 会自动进行增量更新，只分析发生变化的部分，速度非常快。

---

多模块项目支持

如果你的项目采用：

• Maven Multi Module

• Gradle Multi Module

只需要在最外层根目录执行一次：

gitnexus analyze

GitNexus 会自动识别模块之间的依赖关系，并建立统一的知识图谱。

---

四、配置 AI 编辑器（MCP）

为了让 Cursor、Claude Code 等 AI 编辑器能够调用 GitNexus，需要配置 MCP（Model Context Protocol）。

推荐直接执行：

gitnexus setup

GitNexus 会自动检测并配置当前支持的 AI 编辑器，包括：

• Cursor

• Claude Code

• 其他支持 MCP 的工具

整个过程基本无需手动配置。

---

五、后续如何维护？

第一次使用时：

gitnexus analyze

之后，每当项目发生较大的代码变更时，再执行一次：

gitnexus analyze

GitNexus 会自动进行增量分析，更新代码关系、调用链以及知识图谱，无需重新全量构建。

也就是说：

• 第一次建立完整索引；

• 后续代码更新，只需重新执行 gitnexus analyze 即可完成增量更新。

整个维护成本非常低。

---

总结

GitNexus 的核心价值并不是简单地"让 AI 能看代码"，而是帮助 AI 真正理解整个项目的结构与业务关系。

通过提前构建代码知识图谱，AI 可以获得：

• 更准确的代码理解

• 更完整的调用链分析

• 更可靠的影响范围判断

• 更好的重构与修改建议

• 更强的大型项目理解能力

如果你经常使用 Cursor、Claude Code 或其他 AI 编程工具，GitNexus 是一个非常值得加入开发流程的基础能力。