GitNexus：让 AI 真正“看懂”你的代码库

1. GitNexus 简介

GitNexus 是一个零服务端的代码智能引擎，它把你的代码仓库变成一张可交互的知识图谱，让 AI Agent（Cursor、Claude Code、Windsurf 等）真正理解代码的依赖关系、调用链和执行流，而不是靠“猜”。

GitHub：https://github.com/abhigyanpatwari/GitNexus

2. GitNexus 解决了什么问题？

我们每天都在用 Cursor、Claude Code 这类 AI 编程工具，但它们有一个隐藏的致命缺陷：AI 修改了 UserService.validate()，却完全不知道有 N 个函数依赖它的返回值类型，于是 breaking changes 就这样悄无声息地上线了。

这类工具本质上是在做“文本匹配”，依赖 grep 和向量搜索来拼凑上下文。它们没有调用图，追踪不了“谁调用了这个函数”，也无法在改动前评估影响范围。

GitNexus 的解法很直接：在索引阶段就把代码的结构关系全部预计算好——函数调用链、模块依赖、类继承、社区聚类——存进图数据库，让 AI 每次查询时一次性拿到完整上下文，而不是靠 N 次往返查询来拼凑答案。

3. GitNexus 使用方式

GitNexus 提供两套完全独立的运行模式，共享同一套索引流水线。

方式一：Web UI（最快体验，零安装，即开即用）

直接访问：https://gitnexus.vercel.app，拖入一个代码仓库的 ZIP 文件，就能得到：

• 可交互的知识图谱可视化（WebGL 渲染）
• 内置 Graph RAG Agent，支持自然语言提问
• 带来源引用的 AI 回答（[[file:line]] 格式）

背后魔法：整套 parsing、图数据库、向量搜索全部跑在浏览器里，通过 WebAssembly 实现，代码从不离开你的电脑。

限制：浏览器内存限制，适合5000文件以下项目。

方式二：CLI + MCP Server（接入 AI 编辑器）

这是更强大的模式，把 GitNexus 变成你的 AI 编辑器的“神经系统”。

# 第一步：全局安装
npm install -g gitnexus

# 第二步：进入你的项目目录，索引代码库
cd your-project
npx gitnexus analyze

# 第三步：配置编辑器MCP（一次性，自动检测 Cursor/Claude Code/Windsurf）
npx gitnexus setup

analyze 命令会：

1. 索引整个代码库并构建知识图谱
2. 在 .gitnexus 目录存储持久化的 KuzuDB 数据库
3. 自动生成 AGENTS.md、CLAUDE.md 上下文文件
4. 为你的编辑器注册 MCP 工具

之后 Cursor、Claude Code 等工具就能通过 MCP 协议查询这个知识图谱，获取结构化的代码上下文。

方式三：本地后端 + WebUI（团队最佳）

1、本地运行 Web UI

git clone https://github.com/abhigyanpatwari/gitnexus.git
cd gitnexus/gitnexus-web
npm install
npm run dev

打开 http://localhost:5173，拖入任意项目的 ZIP 文件，等待索引完成（进度条会显示 7 个阶段），然后就可以：

• 在图谱上点击节点，查看函数的调用关系
• 在聊天框提问：”哪些模块依赖 AuthService？”
• 查看带精确文件行号引用的 AI 回答

2、本地运行后端

# 先用 CLI 索引本地项目
gitnexus analyze /path/to/your/project

# 启动本地 HTTP 服务
gitnexus serve

# 再打开 Web UI，它会自动检测到本地服务器
# 无需重新上传，直接浏览所有已索引的仓库