GitNexus — 为AI Agent构建代码知识图谱

GitNexus 是什么？

GitNexus 是一个代码库知识图谱引擎——把任意 repo 索引成完整的知识图谱，追踪每一个依赖、调用链、模块聚类和执行流，然后通过 MCP 协议暴露给 AI Agent。

口号很精辟：Building nervous system for agent context.

像 DeepWiki，但更深。DeepWiki 帮你理解代码，GitNexus 帮你分析代码——因为知识图谱追踪的是每一个关系，而不只是描述。

---

两种使用方式

	CLI + MCP	Web UI
用途	本地索引，通过 MCP 连接 AI Agent	浏览器内可视化图谱 + AI 对话
适合	日常开发（Cursor/Claude Code/Codex）	快速探索、演示、一次性分析
安装	npm install -g gitnexus	无需安装，直接访问 gitnexus.vercel.app
隐私	全部本地，无网络请求	全部浏览器内，无服务器
存储	LadybugDB 原生（持久化）	LadybugDB WASM（内存）

Bridge 模式：gitnexus serve 连接两者——Web UI 自动检测本地服务器，可直接浏览所有 CLI 索引过的仓库。

---

核心能力

🔗 知识图谱索引

• 使用 Tree-sitter 解析代码，提取函数、类、模块、依赖关系
• 构建完整的调用链图谱，Agent 不再"瞎改代码"

🔌 MCP 协议集成

• 一行命令接入 Claude Code / Cursor / Codex / Windsurf / OpenCode
• Agent 通过 MCP 工具获取架构级上下文，编辑更精准

🧠 Agent Skills + Hooks（Claude Code 深度集成）

• gitnexus analyze 自动生成 AGENTS.md / CLAUDE.md
• Claude Code 支持 PreToolUse hooks（搜索增强）和 PostToolUse hooks（检测索引过期）
• 即使小模型也能获得完整的架构理解

---

快速开始

# 一键索引你的仓库
npx gitnexus analyze

# 配置 MCP（只需一次）
npx gitnexus setup

# 或手动添加 MCP
claude mcp add gitnexus -- npx -y gitnexus@latest mcp

就这么简单。analyze 会索引代码、安装 Agent Skills、注册 Claude Code Hooks、创建上下文文件——一步到位。

---

为什么值得关注？

1. Agent 可靠性的关键缺失：当前 AI Agent 编辑代码最大的问题是"看不到全貌"——改一个函数不知道谁在调它。GitNexus 直接解决了这个痛点
2. MCP 生态的重要一环：随着 MCP 成为 Agent 工具调用标准，GitNexus 提供的代码理解能力是基础设施级别的
3. 本地优先 + 隐私：所有索引和查询都在本地完成，代码不上传
4. 开源免费：PolyForm Noncommercial 许可，个人和开源项目免费使用

---

支持的编辑器

编辑器	MCP	Skills	Hooks	支持级别
Claude Code	✅	✅	✅	完整
Cursor	✅	✅	—	MCP + Skills
Codex	✅	✅	—	MCP + Skills
Windsurf	✅	—	—	MCP
OpenCode	✅	✅	—	MCP + Skills

---

npm: gitnexus | Web: gitnexus.vercel.app | Discord: 加入社区