GitNexus – Công cụ tạo knowledge graph code chạy hoàn toàn trong trình duyệt

Tóm tắt nhanh (Key Takeaways)
GitNexus biến mọi codebase thành interactive knowledge graph chỉ bằng cách kéo thả file ZIP hoặc dán URL GitHub, không cần server, không cần API key cho chức năng cốt lõi và toàn bộ quá trình chạy client-side trong browser. Graph RAG Agent tích hợp sẵn giúp bạn hỏi đáp tự nhiên về dependencies, call chains và execution flows, trong khi hybrid search (BM25 + semantic) mang lại tốc độ vượt trội. Phù hợp nhất cho developer khám phá codebase lạ, AI coding agents (Cursor, Claude Code) và các đội ngũ ưu tiên bảo mật dữ liệu. Cài đặt chỉ mất 1 phút qua npm, hoặc dùng ngay demo trực tuyến tại gitnexus.vercel.app mà không cần cấu hình.

GitNexus nổi lên như một giải pháp đột phá trong lĩnh vực code intelligence. Đây là công cụ open-source hoàn toàn client-side, cho phép bất kỳ lập trình viên nào cũng có thể xây dựng knowledge graph chi tiết từ repository mà không phải lo lắng về server, chi phí lưu trữ hay rò rỉ dữ liệu. Thay vì upload code lên cloud như nhiều công cụ truyền thống, GitNexus xử lý mọi thứ ngay trong trình duyệt của bạn bằng công nghệ WASM mạnh mẽ.

Với khả năng index toàn bộ file, function, class, import và call relationship, GitNexus không chỉ hiển thị mối quan hệ mà còn cung cấp Graph RAG Agent – một AI agent thông minh có thể trả lời câu hỏi bằng ngôn ngữ tự nhiên dựa trên cấu trúc graph thực sự. Kết quả là bạn có được cái nhìn toàn diện về kiến trúc codebase, giúp rút ngắn thời gian onboarding từ hàng tuần xuống chỉ vài phút.

Công cụ này đặc biệt hữu ích trong kỷ nguyên AI coding assistants. Các mô hình lớn như Claude hay Cursor thường gặp khó khăn khi hiểu ngữ cảnh sâu của dự án lớn. GitNexus bổ sung chính xác lớp context graph mà các công cụ vector-only thiếu, nhờ vào Model Context Protocol (MCP) tích hợp sẵn.

Tính năng chính của GitNexus

GitNexus không dừng lại ở việc vẽ graph đơn thuần. Bộ tính năng được thiết kế dành riêng cho code exploration và AI agent workflow:

• Knowledge graph tương tác: Thu thập mọi dependency, call chain, cluster chức năng và execution flow. Bạn có thể zoom, lọc node, tìm kiếm symbol chỉ trong vài click.
• Graph RAG Agent: Agent sử dụng Cypher query trên graph thực tế để trả lời chính xác hơn so với vector search thông thường. Ví dụ: “Các function nào phụ thuộc vào UserService?” hoặc “Tác động của việc thay đổi class này là gì?”.
• Hybrid search thông minh: Kết hợp BM25 keyword, semantic embedding (local transformers.js) và RRF ranking để tìm kiếm siêu nhanh.
• Impact analysis và risk scoring: Trước khi refactor, bạn biết chính xác “blast radius” của thay đổi với độ sâu, độ tin cậy và mức rủi ro.
• Multi-file rename thông minh: Đổi tên symbol trên toàn dự án mà không bỏ sót file nào.
• Wiki generation tự động: Tạo tài liệu dự án bằng LLM (yêu cầu API key tùy chọn).
• Hỗ trợ rộng rãi ngôn ngữ: TypeScript, JavaScript, Python, Java, Kotlin, C/C++, C#, Go, Rust, PHP, Swift và nhiều ngôn ngữ khác nhờ Tree-sitter parser.

Tất cả tính năng này đều chạy local, đảm bảo bảo mật tuyệt đối và tốc độ cao ngay cả với repository hàng nghìn file.

Kiến trúc hoạt động của GitNexus

GitNexus sử dụng pipeline indexing mạnh mẽ nhưng vẫn giữ nguyên triết lý zero-server. Đầu tiên, công cụ quét cây thư mục và xây dựng mối quan hệ file/folder. Sau đó, Tree-sitter (phiên bản WASM) phân tích AST để trích xuất function, class, method và resolve import/call cross-file.

Kết quả được lưu vào KuzuDB – một graph database cực nhanh. Phiên bản Web UI dùng KuzuDB WASM (in-memory), còn CLI dùng bản native để lưu trữ persistent. Embeddings được tạo bằng transformers.js chạy local trên GPU/CPU hoặc WebGPU, không gửi dữ liệu ra ngoài.

Visualization sử dụng Sigma.js + Graphology với WebGL, mang lại trải nghiệm mượt mà ngay cả trên laptop thông thường. Đối với AI agent, MCP server expose 7 tools mạnh mẽ (query, impact, context, rename…) để Cursor hay Claude Code có thể gọi trực tiếp.

Hướng dẫn cài đặt GitNexus

GitNexus cung cấp hai cách sử dụng chính, phù hợp với mọi mức độ nhu cầu.

Cài đặt và sử dụng Web UI (không cần cài đặt)

Cách đơn giản nhất là truy cập trực tiếp demo chính thức tại https://gitnexus.vercel.app. Bạn chỉ cần:

1. Mở trình duyệt hiện đại (Chrome, Edge, Firefox).
2. Kéo thả file ZIP của repository hoặc dán URL GitHub public.
3. Chờ indexing hoàn tất (thường vài giây đến vài phút tùy kích thước dự án).

Toàn bộ quá trình diễn ra trong tab browser, không yêu cầu đăng ký hay API key.

Cài đặt CLI cho tích hợp sâu và persistent index

Nếu bạn muốn kết nối với AI editors hoặc lưu index lâu dài, hãy dùng phiên bản CLI:

npm install -g gitnexus

Sau khi cài, chạy lệnh sau trong thư mục repository:

gitnexus analyze

Lệnh này sẽ index codebase, tạo file AGENTS.md và CLAUDE.md để hỗ trợ AI agents, đồng thời đăng ký MCP tools tự động.

Để khởi động MCP server (dùng cho Cursor/Claude):

gitnexus mcp

Hoặc kết nối Web UI với index CLI qua chế độ bridge:

gitnexus serve

Sau đó mở lại https://gitnexus.vercel.app, giao diện sẽ tự động nhận diện index local mà không cần upload lại.

Hướng dẫn sử dụng Graph RAG Agent và knowledge graph

Sau khi index hoàn tất, bạn sẽ thấy giao diện chính gồm hai phần chính: graph visualization ở giữa và panel chat Graph RAG bên phải.

• Khám phá graph: Click vào node để highlight dependencies, kéo để di chuyển, dùng thanh tìm kiếm để lọc symbol. Màu sắc và kích thước node phản ánh độ quan trọng và cluster chức năng.
• Chat với Graph RAG Agent: Gõ câu hỏi tự nhiên. Agent sẽ traverse graph thực tế thay vì chỉ tìm kiếm vector, trả về câu trả lời kèm link trực tiếp đến file và line code.
• Impact analysis: Chọn một node rồi hỏi “What if I change this?” để xem danh sách file bị ảnh hưởng kèm risk score.

Với CLI, bạn có thể dùng các lệnh nâng cao:

gitnexus list          # Xem danh sách repo đã index
gitnexus wiki          # Tạo wiki tự động
gitnexus clean         # Xóa index nếu cần

Tích hợp GitNexus với AI coding editors

Một điểm mạnh lớn nhất của GitNexus chính là khả năng kết nối liền mạch với các AI editor hiện đại qua MCP:

• Claude Code: Chạy lệnh claude mcp add gitnexus -- npx -y gitnexus@latest mcp.
• Cursor: Thêm config vào ~/.cursor/mcp.json.
• Windsurf/OpenCode: Tương tự với file config tương ứng.

Sau khi kết nối, AI agent của bạn sẽ tự động có thêm 7 tools graph-aware, giúp trả lời chính xác hơn gấp nhiều lần khi làm việc với codebase phức tạp.

Lợi ích thực tế khi áp dụng GitNexus cho code exploration

GitNexus đặc biệt phù hợp với các tình huống sau:

• Onboarding dự án mới: Thay vì đọc hàng nghìn dòng code, bạn chỉ cần hỏi Graph RAG Agent để nắm tổng quan kiến trúc trong 5 phút.
• Refactoring lớn: Impact analysis giúp dự đoán chính xác side-effect trước khi thay đổi.
• Code review và technical debt detection: Cluster detection tự động chỉ ra các module liên quan chặt chẽ.
• Hỗ trợ AI agents: Cung cấp context graph thay vì chỉ plain text, giảm hallucination đáng kể.

Vì chạy hoàn toàn local, GitNexus còn là lựa chọn lý tưởng cho dự án bảo mật cao hoặc khi làm việc offline.

Lưu ý khi sử dụng và cách tối ưu hiệu suất

GitNexus giới hạn khoảng 5.000 file trên Web UI thuần (do bộ nhớ browser). Với dự án lớn hơn, hãy dùng chế độ gitnexus serve để chuyển sang backend local nhẹ. Hiện tại không hỗ trợ repository private trên demo web (bạn cần clone về và dùng CLI).

Wiki generation yêu cầu cung cấp API key LLM (OpenAI, Anthropic, v.v.). Tất cả index được lưu trong thư mục .gitnexus (đã gitignore) hoặc in-memory session.

Nếu gặp lỗi indexing, thử --force hoặc --skip-embeddings để tăng tốc độ ban đầu.

GitNexus đại diện cho tương lai của code intelligence: nhanh, riêng tư, mạnh mẽ và hoàn toàn miễn phí. Bằng cách kết hợp knowledge graph thực tế với Graph RAG Agent và tích hợp MCP sâu, công cụ này đang thay đổi cách lập trình viên và AI agents tương tác với codebase. Dù bạn là developer cá nhân, thành viên team lớn hay đang xây dựng AI coding workflow, GitNexus đều đáng để thử ngay hôm nay.