GitNexus 是一款为 AI 智能体构建代码理解神经系统的工具，通过将代码库索引为知识图谱来增强 AI 编程助手对代码结构的深度理解。它支持 TypeScript、JavaScript、Python 等多种语言，提供 CLI 和 Web UI 双模式架构。基于 Tree-sitter 解析 AST 并构建包含依赖、调用链等关系的图谱，支持 MCP 协议集成，可自动安装智能体技能用于探索、调试、影响分析及重构。安装简单，支持与 Cursor、Claude Code 等编辑器协作。
GitNexus 是一个为 AI 智能体构建代码理解神经系统的工具，它通过将代码库索引为知识图谱来增强 AI 编程助手对代码结构的深度理解。以下是关于该项目的全面介绍、部署安装步骤及使用指南。
传统 AI 代码助手（如 Cursor、Claude Code、Windsurf）虽然强大，但缺乏对代码库深层结构的理解。当 AI 编辑代码时，无法感知跨文件的依赖关系，容易导致破坏性变更被发布。GitNexus 通过构建完整的代码知识图谱，追踪每个依赖、调用链、集群和执行流程，为 AI 提供全局架构视野。
与传统 Graph RAG 需要 LLM 多轮探索不同，GitNexus 在索引时预计算结构（聚类、追踪、评分），工具一次调用即可返回完整上下文。例如，询问'UserService 依赖什么？'时，impact 工具能一次性返回所有调用者、集群和置信度，而非需要多次查询。
| 模式 | 定位 | 规模限制 | 存储 | 解析 | 隐私 |
|---|---|---|---|---|---|
| CLI + MCP | 日常开发，AI 智能体集成 | 完整仓库，任意大小 | KuzuDB 原生（快速、持久化） | Tree-sitter 原生绑定 | 完全本地，无网络调用 |
| Web UI | 快速探索、演示、一次性分析 | 受浏览器内存限制（约 5k 文件） | KuzuDB WASM（内存中，每会话） | Tree-sitter WASM | 完全在浏览器中，无服务器 |
GitNexus 通过多阶段索引管道构建完整的知识图谱：
通过 MCP（Model Context Protocol）协议，GitNexus 向 AI 智能体暴露 7 个核心工具：
| 工具 | 功能描述 |
|---|---|
list_repos | 发现所有已索引的仓库 |
query | 流程分组的混合搜索（BM25 + 语义 + RRF） |
context | 360 度符号视图（分类引用、流程参与） |
impact | 爆炸半径分析（深度分组、置信度） |
detect_changes | Git 差异影响分析 |
rename | 多文件协调重命名（图 + 文本搜索） |
cypher | 原始 Cypher 图查询 |
MCP 资源系统：
gitnexus://repos - 所有已索引仓库列表gitnexus://repo/{name}/context - 代码库统计和工具gitnexus://repo/{name}/clusters - 所有功能集群gitnexus://repo/{name}/processes - 所有执行流程gitnexus://repo/{name}/schema - 图模式GitNexus 自动安装 4 个智能体技能到 .claude/skills/ 目录：
npm install -g gitnexus
npx gitnexus analyze
git clone https://github.com/abhigyanpatwari/GitNexus.git
cd GitNexus && npm install
npx gitnexus setup
此命令会自动检测已安装的编辑器并配置 MCP。
OpenCode：
编辑 ~/.config/opencode/config.json：
{"mcp":{"gitnexus":{"command":"npx","args":["-y","gitnexus@latest","mcp"]}}}
Cursor（全局配置）：
编辑 ~/.cursor/mcp.json：
{"mcpServers":{"gitnexus":{"command":"npx","args":["-y","gitnexus@latest","mcp"]}}}
Claude Code（完整支持）：
claude mcp add gitnexus -- npx -y gitnexus@latest mcp
在项目根目录运行：
gitnexus analyze
或使用 npx：
npx gitnexus analyze
此命令会：
.gitnexus/ 目录（gitignored）.claude/skills/gitnexus mcp
或启动本地 HTTP 服务器供 Web UI 连接：
gitnexus serve
| 命令 | 功能 |
|---|---|
gitnexus analyze | 索引代码库（或更新过时索引） |
gitnexus analyze --force | 强制完全重新索引 |
gitnexus analyze --skills | 生成仓库特定的技能文件 |
gitnexus analyze --skip-embeddings | 跳过嵌入生成（更快） |
gitnexus analyze --embeddings | 启用嵌入生成（更慢，搜索更好） |
gitnexus list | 列出所有已索引的仓库 |
gitnexus status | 显示当前仓库索引状态 |
gitnexus clean | 删除当前仓库索引 |
gitnexus clean --all --force | 删除所有索引 |
gitnexus wiki | 从知识图谱生成仓库 Wiki |
gitnexus wiki --model <model> | 使用自定义 LLM 模型生成 Wiki |
gitnexus wiki --base-url <url> | 使用自定义 LLM API 基础 URL |
impact({target:"UserService",direction:"upstream",minConfidence:0.8})
返回：
TARGET: Class UserService (src/services/user.ts) UPSTREAM (what depends on this): Depth 1 (WILL BREAK): handleLogin [CALLS 90%] -> src/api/auth.ts:45 handleRegister [CALLS 90%] -> src/api/auth.ts:78 UserController [CALLS 85%] -> src/controllers/user.ts:12
query({query:"authentication middleware"})
context({name:"validateUser"})
detect_changes({scope:"all"})
rename({symbol_name:"validateUser",new_name:"verifyUser",dry_run:true})
对于大型项目，可以使用本地后端模式：
gitnexus serve
然后在 Web UI 中，它会自动检测本地服务器并显示所有 CLI 索引的仓库，无需重新上传或索引。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
使用加密算法（如AES、TripleDES、Rabbit或RC4）加密和解密文本明文。 在线工具，加密/解密文本在线工具，online
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online