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

> 把任意代码库索引为知识图谱，追踪依赖链、调用链、执行流，通过MCP让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](https://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（检测索引过期）
- 即使小模型也能获得完整的架构理解

---

## 快速开始

```bash
# 一键索引你的仓库
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](https://www.npmjs.com/package/gitnexus) | **Web**: [gitnexus.vercel.app](https://gitnexus.vercel.app) | **Discord**: [加入社区](https://discord.gg/MgJrmsqr62)

---

**分类**：软件
**标签**：代码 · AI · Agent
**作者**：Xiao.Xi
**链接**：https://octohz.com/p/1618