abhigyanpatwari / GitNexus

GitNexus ⚠️ Important Notice: GitNexus has NO official cryptocurrency, token, or coin. Any token/coin using the GitNexus name on Pump.fun or any other platform is not affiliated with, endorsed by, or created by this project or its maintainers. Do not purchase any cryptocurrency claiming association with GitNexus. Join the official Discord to discuss ideas, issues etc! GitNexus ⚠️ 重要声明： GitNexus 没有官方加密货币、代币或币种。任何在 Pump.fun 或其他平台上使用 GitNexus 名称的代币/币种均与本项目及其维护者无关，亦未获得其背书或创建。请勿购买任何声称与 GitNexus 有关联的加密货币。欢迎加入官方 Discord 讨论想法、问题等！

Enterprise (SaaS & Self-hosted) - akonlabs.com Building nervous system for agent context. Indexes any codebase into a knowledge graph — every dependency, call chain, cluster, and execution flow — then exposes it through smart tools so AI agents never miss code. 企业版（SaaS 和自托管）- akonlabs.com 为 AI Agent 构建上下文神经系统。它将任何代码库索引为知识图谱——包括每个依赖项、调用链、集群和执行流——然后通过智能工具将其暴露出来，确保 AI Agent 不会遗漏任何代码。

Gitnexus_CLI.1.mp4 Like DeepWiki, but deeper. DeepWiki helps you understand code. GitNexus lets you analyze it — because a knowledge graph tracks every relationship, not just descriptions. Gitnexus_CLI.1.mp4 类似于 DeepWiki，但更深入。DeepWiki 帮助你理解代码，而 GitNexus 让你能够分析代码——因为知识图谱追踪的是每一层关系，而不仅仅是描述。

TL;DR: The Web UI is a quick way to chat with any repo. The CLI + MCP is how you make your AI agent actually reliable — it gives Cursor, Claude Code, Codex, and friends a deep architectural view of your codebase so they stop missing dependencies, breaking call chains, and shipping blind edits. Even smaller models get full architectural clarity, making it compete with Goliath models. 简而言之： Web UI 是与任何代码库进行对话的快捷方式。CLI + MCP 则是让你的 AI Agent 真正可靠的关键——它为 Cursor、Claude Code、Codex 等工具提供了代码库的深度架构视图，从而避免遗漏依赖、破坏调用链或盲目提交代码。即使是较小的模型也能获得完整的架构清晰度，使其能够与巨型模型相媲美。

---

Star History

Two Ways to Use GitNexus

	CLI + MCP	Web UI
What	Index repos locally, connect AI agents via MCP	Visual graph explorer + AI chat in browser
For	Daily development with Cursor, Claude Code, Codex, Windsurf, OpenCode	Quick exploration, demos, one-off analysis
Scale	Full repos, any size	Limited by browser memory (~5k files), or unlimited via backend mode
Install	npm install -g gitnexus	No install — gitnexus.vercel.app
Storage	LadybugDB native (fast, persistent)	LadybugDB WASM (in-memory, per session)
Parsing	Tree-sitter native bindings	Tree-sitter WASM
Privacy	Everything local, no network	Everything in-browser, no server

使用 GitNexus 的两种方式

	CLI + MCP	Web UI
用途	本地索引代码库，通过 MCP 连接 AI Agent	浏览器中的可视化图谱探索器 + AI 对话
适用场景	Cursor, Claude Code, Codex, Windsurf, OpenCode 的日常开发	快速探索、演示、一次性分析
规模	完整代码库，无大小限制	受浏览器内存限制（约 5k 文件），或通过后端模式实现无限制
安装	npm install -g gitnexus	无需安装 — gitnexus.vercel.app
存储	LadybugDB 原生（快速、持久化）	LadybugDB WASM（内存中，按会话）
解析	Tree-sitter 原生绑定	Tree-sitter WASM
隐私	全本地，无网络传输	全浏览器内运行，无服务器

Bridge mode: gitnexus serve connects the two — the web UI auto-detects the local server and can browse all your CLI-indexed repos without re-uploading or re-indexing. 桥接模式： gitnexus serve 将两者连接起来——Web UI 会自动检测本地服务器，并可以浏览所有通过 CLI 索引的代码库，无需重新上传或重新索引。

---

Enterprise

GitNexus is available as an enterprise offering - either as a fully managed SaaS or a self-hosted deployment. Also available for commercial use of the OSS version with proper licensing. 企业版 GitNexus 提供企业级服务——既可以是全托管的 SaaS，也可以是自托管部署。开源版本在获得适当许可的情况下也可用于商业用途。

Enterprise includes:

• PR Review - automated blast radius analysis on pull requests
• Auto-updating Code Wiki - always up-to-date documentation (Code Wiki is also available in OSS)
• Auto-reindexing - knowledge graph stays fresh automatically
• Multi-repo support - unified graph across repositories
• OCaml support - additional language coverage
• Priority feature/language support - request new languages or features
• Upcoming: Auto regression forensics, End-to-end test generation

企业版包含：

• PR 审查 - 对 Pull Request 进行自动化的影响范围分析
• 自动更新的代码 Wiki - 始终保持最新的文档（Code Wiki 也可在开源版中使用）
• 自动重新索引 - 知识图谱自动保持最新
• 多仓库支持 - 跨仓库的统一图谱
• OCaml 支持 - 额外的语言覆盖
• 优先功能/语言支持 - 可请求新语言或新功能
• 即将推出： 自动回归取证、端到端测试生成

👉 Learn more at akonlabs.com 👉 了解更多请访问 akonlabs.com

💬 For commercial licensing or enterprise inquiries, ping us on Discord or drop an email at founders@akonlabs.com 💬 如需商业许可或企业咨询，请在 Discord 上联系我们，或发送电子邮件至 founders@akonlabs.com

---

Development

• ARCHITECTURE.md — packages, index → graph → MCP flow, where to change code
• RUNBOOK.md — analyze, embeddings, stale index, MCP recovery, CI snippets
• GUARDRAILS.md — safety rules and operational “Signs” for contributors and agents
• CONTRIBUTING.md — license, setup, commits, and pull requests
• TESTING.md — test commands for gitnexus and gitnexus-web

开发文档

• ARCHITECTURE.md — 包结构、索引 → 图谱 → MCP 流程、代码修改位置
• RUNBOOK.md — 分析、嵌入、过期索引、MCP 恢复、CI 代码片段
• GUARDRAILS.md — 贡献者和 Agent 的安全规则与操作“标志”
• CONTRIBUTING.md — 许可证、设置、提交和 Pull Request 指南
• TESTING.md — gitnexus 和 gitnexus-web 的测试命令

---

CLI + MCP (recommended)

The CLI indexes your repository and runs an MCP server that gives AI agents deep codebase awareness. CLI + MCP（推荐） CLI 会索引你的代码库并运行一个 MCP 服务器，为 AI Agent 提供深度的代码库感知能力。

Quick Start

# Index your repo (run from repo root)
npx gitnexus analyze

That’s it. This indexes the codebase, installs agent skills, registers Claude Code hooks, and creates AGENTS.md / CLAUDE.md context files — all in one command. 快速开始

# 索引你的仓库（在仓库根目录运行）
npx gitnexus analyze

只需这一条命令，即可完成代码库索引、安装 Agent 技能、注册 Claude Code 钩子，并创建 AGENTS.md / CLAUDE.md 上下文文件。

To configure MCP for your editor, run npx gitnexus setup once — or set it up manually below. 要为你的编辑器配置 MCP，请运行一次 npx gitnexus setup，或者按照下方的说明手动设置。

MCP Setup

gitnexus setup auto-detects your editors and writes the correct global MCP config. You only need to run it once. MCP 设置 gitnexus setup 会自动检测你的编辑器并写入正确的全局 MCP 配置。你只需要运行一次。

Editor	MCP Skills	Hooks (auto-augment)	Support
Claude Code	Yes	Yes	Yes (PreToolUse + PostToolUse)
Cursor	Yes	Yes	— MCP + Skills
Codex	Yes	Yes	— MCP + Skills
Windsurf	Yes	—	— MCP
OpenCode	Yes	Yes	— MCP + Skills

Claude Code gets the deepest integration: MCP tools + agent skills + PreToolUse hooks that enrich searches with graph context + PostToolUse hooks that detect a stale index after commits and prompt the agent to reindex. Claude Code 拥有最深度的集成：MCP 工具 + Agent 技能 + PreToolUse 钩子（用图谱上下文丰富搜索）+ PostToolUse 钩子（在提交后检测索引是否过期并提示 Agent 重新索引）。

---

Community Integrations

Built by the community — not officially maintained, but worth checking out. 社区集成 由社区构建——非官方维护，但值得一试。

Project	Author	Description
pi-gitnexus	@tintinweb	GitNexus plugin for pi — pi install npm:pi-gitnexus
gitnexus-stable-ops	@ShunsukeHayashi	Stable ops & deployment workflows (Miyabi ecosystem)

Have a project built on GitNexus? Open a PR to add it here! 如果你有基于 GitNexus 构建的项目，请提交 PR 将其添加到此处！

---

Manual Configuration

(See original text for specific JSON/TOML configuration blocks for Claude Code, Codex, Cursor, OpenCode, and Codex) 手动配置 （请参考原文获取 Claude Code, Codex, Cursor, OpenCode 和 Codex 的具体 JSON/TOML 配置代码块）

CLI Commands

• gitnexus setup # Configure MCP for your editors (one-time)
• gitnexus analyze [path] # Index a repository (or update stale index)
• gitnexus analyze --force # Force full re-index
• gitnexus analyze --skills # Generate repo-specific skill files from detected communities
• gitnexus analyze --skip-embeddings # Skip embedding generation (faster)
• gitnexus analyze --skip-agents-md # Preserve custom AGENTS.md/CLAUDE.md
• gitnexus analyze --skip-git # Index folders that are not Git repositories
• gitnexus analyze --embeddings # Enable embedding generation (slower, better search)
• gitnexus analyze --verbose # Log skipped files when parsers are unavailable

CLI 命令

• gitnexus setup # 为你的编辑器配置 MCP（一次性）
• gitnexus analyze [path] # 索引仓库（或更新过期索引）
• gitnexus analyze --force # 强制完全重新索引
• gitnexus analyze --skills # 根据检测到的社区生成仓库特定的技能文件
• gitnexus analyze --skip-embeddings # 跳过嵌入生成（速度更快）
• gitnexus analyze --skip-agents-md # 保留自定义的 AGENTS.md/CLAUDE.md
• gitnexus analyze --skip-git # 索引非 Git 仓库的文件夹
• gitnexus analyze --embeddings # 启用嵌入生成（速度较慢，搜索效果更好）
• gitnexus analyze --verbose # 当解析器不可用时记录跳过的文件