一句话概括

把任何代码库索引成知识图谱（依赖、调用链、执行流），通过 CLI + MCP 让 AI agent 拥有完整的代码架构视野，避免盲改漏依赖。

解决的问题

  • AI agent 写代码时"管中窥豹"——只看到当前文件，不知道全局结构和依赖关系
  • 小型模型（7B-70B）的架构理解能力有限，容易做出破坏性修改
  • 开发者在 IDE 和 AI chat 之间反复切换，效率低下
  • 大型代码库无法一次性塞进 context window

核心机制与工作流

  1. 索引阶段：使用 Tree-sitter 解析代码，将每段代码（函数、类、模块）及其关系（调用、继承、依赖、组合）写入 LadybugDB 知识图谱
  2. 查询阶段：通过 MCP 或 CLI 提供智能查询（"这个函数被谁调用？""这段代码会影响哪些模块？"）
  3. 分析阶段：agent 利用图谱信息做出更精准的推理和修改

数据流

graph LR
    A[代码库] --> B[Tree-sitter 解析]
    B --> C[知识图谱 LadybugDB]
    C --> D[MCP 接口]
    C --> E[CLI 接口]
    C --> F[Web UI]
    D --> G[Claude Code / Cursor / Codex]

安装方式

CLI 安装（推荐）

npm install -g gitnexus

Web UI（无需安装）

直接浏览器访问：https://gitnexus.vercel.app

Bridge 模式

gitnexus serve  # 启动本地服务，Web UI 自动连接本地已索引的仓库

适用人群

  • 使用 Cursor、Claude Code、Codex、Windsurf、OpenCode 的开发者
  • 需要让 AI agent 理解大型代码库的团队
  • 希望在浏览器中快速浏览代码图谱的研发

应用场景

场景 说明
代码审查 快速定位修改影响范围
重构 安全地识别所有需要修改的关联文件
新人入职 可视化浏览代码架构，理解模块关系
Bug 定位 追踪调用链找到根因
AI 辅助开发 给 agent 提供代码库的完整上下文

优缺点

优点 缺点
零服务器，纯本地运行 初次索引大项目需要时间
同时提供 CLI、MCP、Web UI 三种接口 企业级功能（PR Review 等）需商业版
Tree-sitter 原生绑定，解析速度快 需要 Node.js 20+
支持任意规模代码库 不支持 WASM 以外的浏览器模式大项目
集成主流 AI 编程工具

类似项目对比

项目 差异
DeepWiki DeepWiki 帮你理解代码，GitNexus 让你分析代码（知识图谱追踪关系而非文本描述）
Sourcegraph Sourcegraph 需要服务器，GitNexus 本地运行
OpenAI Codex Codex 是代码生成，GitNexus 是代码理解

注意事项 / 坑

  • 企业版需单独授权，OSS 版使用需注意许可
  • 同名的 GitNexus 加密货币代币均与本项目无关，谨防诈骗
  • 浏览器模式（WASM）不支持超过 5000 文件的仓库

相关 Skills

  • OpenSpec — 可与 GitNexus 配合，先理解再设计
  • Superpowers — 完整的开发方法论，GitNexus 可嵌入其工作流

来源