Chuyển code thành đồ thị kiến thức cho AI agents

TL;DR

GitNexus index toàn bộ code thành knowledge graph — track mọi dependency, call chain, cluster, và execution flow. Sau đó expose qua MCP tools để AI agent như Cursor, Claude Code hiểu cấu tr code, không bỏ sót dependency hay phá break call chain khi edit.

Nói đơn giản: Tool này giúp AI đọc code của mình hiểu rõ như mình hiểu — biết function nào gọi function nào, thay đổi chỗ này sẽ ảnh hưởng chỗ nào.

Bài này dành cho ai?

1. Dev dùng AI coding assistant (Cursor, Claude Code, Windsurf…)

Vấn đề: AI edit một chỗ nhưng không biết có 47 function khác phụ thuộc, dẫn đến break code Khi nào cần: Khi muốn AI hiểu cấu trúc code thật sự, không chỉ đọc file text Được gì: AI biết trước impact của thay đổi, giảm bug sau khi ship

2. Team lead / Architect muốn standardize AI workflow

Vấn đề: Mỗi dev dùng AI khác nhau, không có consistent context Khi nào cần: Khi muốn tất cả AI agent trong team có cùng understanding về codebase Được gì: Một global MCP server phục vụ mọi repo, không cần config lại

3. Dev muốn tạo documentation tự động

Vấn đề: Viết docs lúc đầu rồi bỏ, code thay đổi docs cũng outdated Khi nào cần: Cần overview kiến trúc, module nào gọi module nào Được gì: Wiki tự generate từ knowledge graph, luôn up-to-date

Các điểm chính

1. AI giờ biết “ai phụ thuộc ai” trước khi edit GitNexus precompute toàn bộ relationship lúc index — lúc hỏi AI không cần query lần lượt 4-5 bước mà nhận ngay complete context. → Làm gì: Chạy npx gitnexus analyze một lần, AI agent tự có full architectural view

2. Hai mode: CLI cho dev thường xuyên, Web UI cho explore nhanh CLI dùng KuzuDB native, persistent, không giới hạn size. Web UI chạy trong browser, tiện demo nhưng limited bởi browser memory (~5k files). → Làm gì: Dùng CLI cho daily work, Web UI khi cần show nhanh cho người khác

3. Claude Code được tích hợp sâu nhất Không chỉ MCP tools mà còn agent skills (Exploring, Debugging, Impact Analysis, Refactoring) + hooks tự động reindex sau mỗi commit. → Làm gì: Dùng Claude Code nếu muốn AI tự maintain knowledge graph up-to-date

4. Multi-repo architecture — set up một lần dùng mọi repo Registry lưu ở ~/.gitnexus/registry.json, MCP server đọc registry rồi connect đến KuzuDB của từng repo. Không cần config riêng cho từng project. → Làm gì: Chạy gitnexus setup một lần, sau đó analyze bao nhiêu repo tùy thích

5. Smaller models cũng làm được việc lớn Vì tools đã làm heavy lifting (precomputed structure), LLM nhỏ vẫn có full architectural context — không cần goliath model. → Làm gì: Thử dùng Claude 3.5 Sonnet thay vì 4o, vẫn có kết quả tương đương

6. 13 ngôn ngữ được hỗ trợ TypeScript, JavaScript, Python, Java, Kotlin, C, C++, C#, Go, Ruby, Rust, PHP, Swift. → Làm gì: Không cần lo code mình dùng ngôn ngữ gì

7. Bảo mật — 100% local CLI: không network call, index trong .gitnexus/ (gitignored). Web: chạy trong browser, không upload đâu cả. → Làm gì: Yên tâm dùng cho private repo

Quick Start

1. Cài đặt và index repo:

npm install -g gitnexus
cd /path/to/your-repo
npx gitnexus analyze

2. Setup cho editor (chạy một lần):

npx gitnexus setup

3. Dùng luôn — mở Cursor/Claude Code, AI giờ biết:

• Function nào gọi function nào
• Thay đổi chỗ này ảnh hưởng những chỗ nào
• Execution flow từ entry point đến chỗ cần debug