GitNexus 代码知识图谱引擎

GitNexus 是什么

GitNexus 是一个零服务端的代码智能引擎。它把代码库索引成一张知识图谱，节点是符号，边是调用、依赖与执行流程，从而让 AI 编码 Agent 能够「理解」代码结构，而不只是做文本匹配。

你可以通过三种方式使用它：

• 编码 Agent 的 MCP 工具
• 命令行 CLI
• 网页版图谱浏览器

快速开始

运行环境要求 Node.js 22.18+（22.x）或 24.11+。

# 在仓库根目录执行
npx gitnexus analyze

# 一次性为编辑器配置 MCP
npx gitnexus setup

analyze 会构建索引、安装 Agent 技能、注册 Claude Code hooks，并生成 AGENTS.md / CLAUDE.md 上下文文件；setup 负责为编辑器配置 MCP。若只想建索引，可加 --index-only。

核心能力

于是你可以直接问 Agent：「谁调用了这个函数？」「这次改动会影响什么？」

常用命令

gitnexus analyze                 # 刷新当前仓库索引
gitnexus analyze --watch         # 文件变化时自动重建索引
gitnexus query "authentication"  # 在图谱中搜索
gitnexus impact UserService --direction upstream
gitnexus status                  # 查看索引新鲜度
gitnexus serve                   # 为 Web UI 提供索引服务

多个 Agent 并发时，建议启动一个 gitnexus mcp --http --port 3111 服务，客户端连接 http://127.0.0.1:3111/mcp。

编辑器与语言支持

gitnexus setup 可自动识别 Claude Code、Cursor、Codex、Antigravity、Factory Droid、OpenCode、CodeBuddy、Qoder 等编辑器；Windsurf 需手动配置 MCP。

已注册的语言提供方包括 C、C++、C#、COBOL、Dart、Go、Java、JavaScript、Kotlin、Objective-C、PHP、Python、Ruby、Rust、Swift、TypeScript、Vue 和 Zig，具体支持程度因语法结构而异。

安全与隐私

CLI 在本地完成索引，不调用 LLM；可选的远程向量嵌入、Wiki 生成与 AI 对话使用你自行配置的服务商。将索引暴露给他人前，请先阅读安全说明与部署认证文档。

注意事项

• 许可证为 PolyForm Noncommercial，商业使用需确认授权。
• 索引结果受语言支持与证据完整度影响，需关注报告中提示的歧义与覆盖限制。