Graphicle: Hợp nhất đồ thị mã nguồn và bộ nhớ cho tác nhân lập trình AI trong một chương trình Rust

Trong bối cảnh các tác nhân lập trình AI (coding agent) ngày càng phổ biến, một trong những nỗi đau lớn nhất của lập trình viên là việc agent liên tục đọc lại mã nguồn, quên mất các quyết định kỹ thuật trước đó và đưa ra câu trả lời thiếu căn cứ. Graphicle — dự án mã nguồn mở mới xuất hiện trên Hacker News — hứa hẹn giải quyết vấn đề này bằng cách gộp đồ thị mã nguồn và bộ nhớ dự án vào một chương trình Rust duy nhất.

Giấy phép Apache 2.0

Graphicle là gì?

Graphicle ánh xạ kho mã của bạn thành một đồ thị mã nguồn (code graph), đồng thời ghi nhớ tài liệu dự án, các quyết định thiết kế và những phiên làm việc trước đây của agent. Khi agent đặt câu hỏi, công cụ này trả về các trích đoạn có dẫn nguồn (cited excerpts) — kèm chính xác tên tệp và số dòng — từ cả hai nguồn dữ liệu trên.

Điểm đáng chú ý là Graphicle chạy hoàn toàn trên máy cục bộ: không cần API key, không cần tài khoản, không thu thập dữ liệu từ xa (telemetry). Công cụ tương thích với Claude Code, Cursor, Codex, VS Code, Claude Desktop và bất kỳ ứng dụng khách MCP nào.

Phiên bản phát hành mới nhất

Cài đặt và khởi tạo nhanh

Người dùng macOS có thể cài đặt chỉ với vài lệnh đơn giản qua Homebrew:

brew install graphicle-ai/tap/graphicle
cd your-repo
graphicle setup

Với những ai không dùng Homebrew, có thể tải script cài đặt trực tiếp. Đáng lưu ý là hiện chưa có bản dựng gốc cho Windows; người dùng Windows có thể thử chạy bản Linux trong WSL2, dù chưa được kiểm nghiệm đầy đủ. Nhóm phát triển cho biết bản Windows gốc đang nằm trong kế hoạch.

Lệnh graphicle setup sẽ lập chỉ mục kho mã, xây dựng đồ thị mã nguồn và tự động kết nối tới các tác nhân lập trình mà nó phát hiện được. Công cụ cũng bật tính năng ghi lại phiên làm việc, điều hướng tìm kiếm của Claude Code ưu tiên đồ thị mã nguồn, thêm một mục ngắn vào tệp AGENTS.md và cài đặt các Git hook để dự án luôn được cập nhật. Mọi tệp bị thay đổi đều được liệt kê rõ ràng và sao lưu trước; lệnh graphicle disconnect sẽ hoàn tác toàn bộ.

Sau đó, bạn có thể hỏi agent bằng câu lệnh tự nhiên như: "dùng graphicle để tìm nơi các yêu cầu lỗi được thử lại". Hoặc hỏi trực tiếp từ terminal:

$ graphicle ask "thuế được cộng vào giá ở đâu?"

Vì sao Graphicle khác biệt?

Có ba trụ cột chính làm nên giá trị của công cụ này:

Đồ thị mã nguồn

Graphicle phân tích tệp, hàm, lớp, lời gọi hàm và câu lệnh import bằng tree-sitter — không cần đến mô hình ngôn ngữ. Bạn có thể tìm kiếm đồ thị, giải thích một ký hiệu (symbol), truy vết đường đi hoặc xuất ra đồ thị HTML tương tác. Với lệnh graphicle graph extract . --code-only, bạn có thể xem những gì phụ thuộc vào một ký hiệu cụ thể.

Bộ nhớ dự án

Tài liệu Markdown, PDF, tệp Office, HTML, các quyết định đã được duyệt, cùng những phiên làm việc trước đây của Claude Code và Codex đều được lập chỉ mục và tìm kiếm song song với mã nguồn. Đặc biệt, bộ nhớ được gắn kết với mã: một ký ức về một hàm sẽ được đánh dấu là lỗi thời khi mã đó thay đổi — nhưng nếu bạn chỉ sửa phần khác trong cùng tệp, ký ức đó vẫn còn giá trị.

Ngữ cảnh có dẫn nguồn trong giới hạn token

Lệnh graphicle context và các công cụ MCP trả về các trích đoạn kèm nguồn gốc, nằm trong một ngân sách token cho trước, mà không hề gọi đến mô hình nào. Điều này giúp tiết kiệm chi phí và giữ cho ngữ cảnh của agent luôn gọn gàng.

Hiệu năng vượt trội

Điểm thu hút mạnh mẽ nhất có lẽ là tốc độ. Trên kho mã Kubernetes với 31.000 tệp, engine phiên bản 0.1.0 hoàn thành một lượt trích xuất chỉ bằng mã trong 3 phút 18 giây, so với 26 phút 38 giây của Graphify 0.9.88 — nhanh hơn gần 8 lần, và cả hai đều xây dựng cùng một đồ thị. Trên Django, một bản thử nghiệm thậm chí chạy trong 7,5 giây so với 72,8 giây của Graphify 0.9.77.

Về bộ nhớ, trong một phép so sánh với bảy hệ thống ghi nhớ khác, bản thử nghiệm của Graphicle không hề thua kém trên cả ba bộ dữ liệu phát triển.

So sánh: Graphicle hay bộ đôi công cụ?

Điểm khác biệt cốt lõi của Graphicle là triết lý một chương trình thay vì cả một chồng công cụ:

• Cài đặt: Thay vì hai công cụ chạy trên hai runtime khác nhau và thường kèm một máy chủ cơ sở dữ liệu, bạn chỉ cần một lần cài đặt duy nhất.
• Kết nối agent: Thay vì cấu hình từng công cụ cho từng agent, graphicle setup tự động phát hiện và kết nối tất cả.
• Lưu trữ: Thay vì tệp đồ thị cộng với cơ sở dữ liệu của máy chủ bộ nhớ, mọi thứ nằm trong một tệp SQLite duy nhất.
• Dẫn nguồn và phê duyệt: Mỗi trích đoạn đều kèm tên tệp và số dòng; mọi ký ức do agent đề xuất đều phải chờ bạn phê duyệt.

Nền tảng hỗ trợ: macOS và Linux

Quyền riêng tư và cục bộ

Với các nhà phát triển Việt Nam làm việc trong môi trường doanh nghiệp có yêu cầu bảo mật cao, đây có thể là điểm cộng lớn. Toàn bộ nguồn dữ liệu, ký ức và đồ thị mã nguồn nằm trong một kho dữ liệu SQLite duy nhất — tại ~/Library/Application Support/Graphicle trên macOS hoặc ~/.local/share/graphicle trên Linux. Ứng dụng web và các điểm cuối HTTP/MCP chỉ lắng nghe trên 127.0.0.1 (loopback).

Graphicle chỉ kết nối mạng khi bạn yêu cầu: một mô hình hoặc trình kết nối do bạn cấu hình, GitHub CLI cho một số lệnh đồ thị, hoặc lệnh cập nhật. Cơ chế đồng bộ tôn trọng .gitignore và tự động bỏ qua các tệp .env, khóa và thông tin xác thực.

Việc xóa một ký ức hoặc một phiên đã ghi lại cũng sẽ xóa mọi thứ được suy ra từ nó, kèm theo một "biên lai xóa" được băm chuỗi.

Có cần API key không?

Câu trả lời là không, với phần lớn tính năng. Đồ thị mã nguồn (ở chế độ --code-only), đồng bộ, ngữ cảnh, máy chủ MCP, ghi lại phiên và ứng dụng đều hoạt động mà không cần mô hình. Chỉ khi bạn muốn graphicle ask viết câu trả lời, đề xuất ký ức từ nguồn, hoặc đọc tài liệu và hình ảnh trong một lượt trích xuất đầy đủ thì mới cần mô hình. Bạn có thể dùng mô hình cục bộ qua Ollama hoặc bất kỳ máy chủ tương thích OpenAI nào.

Giấy phép và nguồn gốc

Graphicle được phát hành theo giấy phép Apache 2.0 — miễn phí sử dụng, sửa đổi và phân phối, kể cả cho mục đích thương mại. Engine đồ thị mã nguồn là một bản chuyển sang Rust của Graphify (do Safi Shamsi và cộng đồng phát triển), được cập nhật song song với các bản phát hành của Graphify và ghi công đầy đủ trong phần tiêu đề tệp cũng như tệp NOTICE. Phần bộ nhớ, các công cụ bộ nhớ, ứng dụng và ghi lại phiên là những bổ sung không có trong Graphify.

Nếu đang chuyển từ Graphify sang, lệnh graphicle setup sẽ đề nghị chuyển đổi kho mã, sao lưu từng tệp và không bao giờ xóa thư mục graphify-out/.

Kết luận

Graphicle thể hiện một hướng tiếp cận đáng chú ý cho bài toán ngữ cảnh của tác nhân lập trình AI: thay vì để agent liên tục đọc lại toàn bộ kho mã, công cụ này cung cấp một lớp bộ nhớ có cấu trúc, có dẫn nguồn và chạy hoàn toàn cục bộ. Với hiệu năng vượt trội nhờ Rust và triết lý "một chương trình thay vì cả chồng công cụ", đây là dự án đáng để các nhà phát triển Việt Nam đang làm việc với Claude Code, Cursor hay Codex thử nghiệm.

Bạn có thể tham gia thảo luận cùng cộng đồng trên Discord:

Tham gia Discord