TL;DR
GitNexus là một zero-server code intelligence engine. Chạy npx gitnexus analyze một lần, nó parse toàn bộ repo bằng Tree-sitter, dựng knowledge graph của mọi function call, import, class inheritance, rồi expose 16 MCP tool cho Claude Code / Cursor / Windsurf dùng. Kết quả: AI agent biết chính xác hàm nào phụ thuộc vào hàm nào trước khi sửa code — thay vì đoán mò như hiện tại. Repo đã đạt 28.8K GitHub stars, 3.3K forks, và đang trending mạnh sau một viral post trên X.
What's new
AI coding agent ngày nay "code mù" ở cấp kiến trúc. Agent của bạn sửa UserService.validate() mà không biết 47 hàm khác đang phụ thuộc vào return type của nó. Breaking change được ship. Production cháy. Đây là câu chuyện quen thuộc mà ai dùng Cursor hoặc Claude Code đều từng dính.
GitNexus tấn công vấn đề này ở gốc: thay vì để agent dò grep từng lượt một, nó pre-compute toàn bộ cấu trúc dependency ngay lúc index. Khi agent hỏi "hàm này bị gì phụ thuộc?", graph trả lời đầy đủ trong 1 query, không phải 10 lượt tool call.
Điểm khác biệt so với các code RAG thông thường: GitNexus không chỉ embed code vào vector DB. Nó build một graph có cạnh thật — call edges, import edges, inheritance edges — và group các symbol liên quan thành community bằng thuật toán Leiden clustering kèm cohesion score.
Technical facts
- Parser: Tree-sitter AST trên 14 ngôn ngữ (TypeScript, Python, Java, Go, Rust, C#, PHP, Swift, C/C++, v.v.)
- 16 MCP tool expose cho AI agent, gồm: impact & blast-radius analysis kèm confidence score, hybrid search (BM25 + semantic + Reciprocal Rank Fusion), symbol context 360°, git-diff change detection, multi-file coordinated rename với graph validation, và raw Cypher query.
- Execution-flow tracing đi từ entry point xuyên qua toàn bộ call chain.
- Auto-generated wiki: LLM đọc graph structure để sinh documentation có cross-reference sẵn.
- Persistence: LadybugDB (storage layer nội bộ).
- Supply chain security: Docker image ký bằng Cosign, có admission policy cho Kubernetes.
- Stack: 98% TypeScript, ~767 commits, active development.
Comparison
So với workflow grep + RAG truyền thống mà hầu hết AI agent đang dùng:
| Tình huống | Grep + RAG | GitNexus |
|---|---|---|
| Câu hỏi dependency | 5–10 tool call, trả lời một phần | 1 query, answer đầy đủ từ graph |
| Rename symbol cross-file | Agent đoán, thường miss reference | Coordinated rename qua 5+ file, validate bằng graph |
| Blast radius trước khi edit | Không có | Pre-computed lúc index |
| Context mỗi call | Raw file chunk | Symbol-level 360° + full call chain |
| Token cost review PR | Cao (đọc rộng) | Giảm ~6.8× token (theo benchmark công bố) |
Trong cùng ngách có vài project tương tự — codegraph, code-review-graph, graphify — nhưng GitNexus đang dẫn về star count và độ phủ integration (Claude Code, Cursor, Codex, Windsurf, OpenCode cùng hỗ trợ đầy đủ MCP + skill + hook).
Use cases
Ngăn breaking change trước khi commit: agent chuẩn bị sửa một public API, GitNexus chạy blast-radius analysis và liệt kê mọi caller bị ảnh hưởng. Agent biết phải cập nhật cả stack chứ không chỉ file đang mở.
"Nâng hạng" model rẻ: GPT-4o-mini hoặc Haiku tự bản thân không suy luận được kiến trúc từ context window hạn chế. Khi graph đưa trực tiếp cấu trúc dependency vào prompt, model nhỏ dừng làm gãy call chain — nghĩa là tiết kiệm đáng kể chi phí agent run.
Onboarding codebase mới: drop repo vào, nhận wiki tự sinh cộng với graph UI tương tác. Developer mới hiểu kiến trúc trong vài giờ thay vì vài tuần.
Cross-file refactor: đổi tên một symbol, GitNexus apply change đồng bộ qua mọi file liên quan và validate bằng graph để chắc không miss reference.
Limitations & pricing
License: PolyForm Noncommercial — miễn phí cho use case phi thương mại. Commercial cần license qua akonlabs.com (bản enterprise managed SaaS hoặc self-hosted).
Bản browser (client-side) bị giới hạn bởi RAM, handle được tầm ~5,000 file. Bản CLI không giới hạn scale. Ngôn ngữ ngoài 14 ngôn ngữ core chỉ có coverage từng phần (import-level, chưa resolve call).
Bản enterprise thêm: PR review automation, auto-reindex on push, multi-repo support, và OCaml coverage (land enterprise trước).
What's next
Roadmap public signal: mở rộng language coverage, deeper CI integration, và PR review automation theo hướng "agent review pre-merge" dựa trên diff-to-graph mapping. Khi hệ sinh thái AI coding agent càng lúc càng nhiều (Claude Code, Cursor, Windsurf, OpenCode, Codex, Cline), các lớp "code intelligence" đứng giữa model và codebase như GitNexus sẽ thành infrastructure bắt buộc — tương tự LSP đã thành mặc định cho editor.
Muốn thử: chạy npx gitnexus analyze trong repo của bạn, mở Claude Code, hỏi nó "what depends on X?" và so sánh câu trả lời với lúc không có graph.
Nguồn: GitHub repo, Cult of Claude, gitnexus.vercel.app.