Hãy hỏi coding agent của bạn xem một hàm được gọi ở đâu rồi xem chuyện gì xảy ra. Nó grep, đọc ba file, grep lại bằng một pattern khác, đọc thêm bốn file nữa, và cuối cùng cũng trả lời đúng — sau khi đã lấp đầy context bằng source code mà nó sẽ quên ngay khi phiên làm việc kết thúc. Hỏi thêm một câu nữa, nó lại lặp lại toàn bộ quy trình từ đầu.
codebase-memory-mcp xóa bỏ vòng lặp đó. Với 41.536 sao, giấy phép MIT và được viết bằng C, đây là công cụ trong làn sóng tooling dành cho agent năm nay mang lại hiệu quả cao nhất với ít thay đổi nhất đối với cách bạn làm việc. Nó cho agent bộ nhớ về code của bạn. Nó không cho team bạn bộ nhớ về công việc — và đó là hai bài toán hoàn toàn khác nhau.
Tóm tắt nhanh
Đây là một trong năm bài phân tích chuyên sâu nằm trong bản tổng hợp của chúng tôi về các công cụ mã nguồn mở giúp mở rộng khả năng của coding agent.
codebase-memory-mcp lập chỉ mục một repository thành một knowledge graph bền vững gồm các hàm, class, chuỗi gọi và route, rồi trả lời các câu hỏi về cấu trúc từ graph đó thay vì grep. Dự án đo được: năm truy vấn cấu trúc qua graph tốn khoảng 3.400 token, so với khoảng 412.000 token khi đọc từng file. Đây là một binary native duy nhất, không cần runtime hay API key, chạy hoàn toàn cục bộ và tương thích với mọi MCP client. Hãy cài nó trước. Rồi sau đó hãy quyết định riêng xem bản ghi về những gì agent của bạn đã làm sẽ được lưu ở đâu.
Nó làm được gì
Quá trình phân tích cú pháp chạy qua tree-sitter với hơn 160 ngôn ngữ, kèm thêm lớp phân giải kiểu ngữ nghĩa (semantic type resolution) cho một nhóm ngôn ngữ cốt lõi gồm Python, họ TypeScript và JavaScript, Go, Java, Rust, C# và C++. Kết quả được cung cấp qua 15 công cụ MCP, bao quát tìm kiếm, truy vết chuỗi gọi, tổng quan kiến trúc, phân tích tác động, phát hiện dead code, truy vấn graph và liên kết HTTP giữa các service. Bất kỳ client nào hỗ trợ Model Context Protocol đều dùng được, và dự án liệt kê 45 bề mặt agent được hỗ trợ.
| Chỉ số | Kết quả báo cáo |
|---|---|
| Năm truy vấn cấu trúc | ~3.400 token so với ~412.000 khi đọc từng file |
| So sánh đã qua bình duyệt | Ít hơn 10 lần token, ít hơn 2,1 lần lệnh gọi công cụ, chất lượng câu trả lời 83% |
| Lập chỉ mục nhân Linux | 28 triệu dòng, 75 nghìn file, 3 phút |
| Độ trễ truy vấn cấu trúc | Dưới 1ms |
Hãy đọc hai con số token đó cùng nhau. Mức giảm 99% chỉ ứng với năm truy vấn cấu trúc — tức trường hợp tốt nhất của graph. Con số trong bản preprint trên 31 repository là 10 lần. Hãy tính toán dựa trên mức 10 lần và coi bất cứ kết quả tốt hơn là phần thưởng thêm.
Cài đặt
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash
Windows có bản cài đặt bằng PowerShell, và dự án khuyến nghị bạn đọc script trước khi chạy. Trình cài đặt sẽ phát hiện các coding agent của bạn và ghi các mục MCP tương ứng. Hãy khởi động lại agent và yêu cầu nó lập chỉ mục cho dự án.
Hai thiết lập đáng áp dụng ngay từ ngày đầu tiên:
codebase-memory-mcp config set auto_index true
codebase-memory-mcp --ui=true --port=9749
Trình xem graph được tích hợp sẵn trong binary và là một cách kiểm tra nhanh hữu ích để chắc chắn rằng chỉ mục đã bao phủ đúng những gì bạn mong đợi.
Có hai lưu ý mà chính dự án ghi rõ, cả hai chỉ mất ba mươi giây để đọc. Microsoft Defender có thể gắn cờ nhầm một binary phát hành là false positive; dự án lưu ý rằng thông thường 61 trong khoảng 62 engine trả về kết quả sạch, và cùng nhóm phát hiện này cũng từng bắt nhầm cả GitHub CLI lẫn bộ công cụ Go của chính Microsoft. Và công cụ này đọc codebase của bạn rồi ghi vào các file cấu hình agent — đó chính là chức năng của nó, được nói rõ ràng. Hãy đọc script cài đặt trước khi pipe nó vào shell.
Vì sao nên bắt đầu với công cụ này
Mọi công cụ khác trong làn sóng tooling hiện tại đều đòi hỏi bạn phải thay đổi cách làm việc. Thư viện role thay đổi cách bạn viết prompt. Worktree song song thay đổi cách bạn tổ chức công việc. Truy cập web thay đổi những gì bạn yêu cầu.
Còn công cụ này không thay đổi gì cả mà lại giúp mọi phiên làm việc rẻ hơn. Không có thói quen nào phải học.
Hiệu ứng về chất lượng là nửa phần bị đánh giá thấp. Một agent tiêu tốn 400.000 token để đọc file thì cũng mất đi bấy nhiêu không gian để suy luận về vấn đề của bạn, và khả năng nhớ lại những gì nó đọc lúc đầu sẽ giảm dần trong một phiên dài. Trả lời từ graph giúp giữ context luôn rảnh.
Sự thay đổi này thể hiện rõ ở những gì bạn hỏi. Những câu hỏi trước đây bạn né tránh vì tốn 50.000 token và hai phút giờ gần như miễn phí. Phân tích tác động trước khi đổi signature biến “tôi nghĩ là an toàn” thành một danh sách cụ thể. Truy vết chuỗi gọi trên một repository lạ hiệu quả hơn hẳn việc đọc ngược lên qua năm file với hy vọng tìm ra điểm vào.
Bộ nhớ về code không phải là bộ nhớ về công việc
Đây là ranh giới, và nó rất rõ ràng.
Graph được xây dựng từ code của bạn, nên nó biết code của bạn là gì. Nó có thể cho bạn biết helper retry gọi đến payments client. Nó không thể cho bạn biết vì sao cơ chế backoff thay đổi vào tháng Bảy, ai là người quyết định, phương án thay thế là gì, hay có ai review hay không. Lịch sử đó từng tồn tại trong một phiên terminal đã biến mất.
Các team cảm nhận điều này như một sự bất đối xứng kỳ lạ: agent nhớ về codebase tốt hơn bất kỳ ai trong team, nhưng lại không nhớ chút gì về những quyết định đã tạo ra nó.
Chỉ mục còn mang tính cục bộ theo từng máy. Nó nằm trong một thư mục cache thuộc một tài khoản, được chia sẻ giữa các phiên cục bộ của bạn thông qua một coordination daemon, và dừng lại ở ranh giới của chiếc máy đó.
Bản ghi công việc nằm ở đâu
Task là đơn vị công việc chính trong Sharkly. Nó lưu giữ yêu cầu, context, quá trình thực thi, các điểm tắc nghẽn và kết quả trong một nơi chia sẻ chung, thay vì phân tán chúng khắp các prompt riêng tư và phiên terminal.
Mỗi thành phần đảm nhận một việc. Agent định nghĩa cách xử lý công việc. Computer cung cấp host và tài nguyên cục bộ. Runtime thực hiện phiên agent thực tế, dùng chính công cụ coding đã được cài ở đó. Còn Task vẫn là bản ghi chia sẻ.
Cách tách bạch đó khiến sự kết hợp trở nên cụ thể. Chỉ mục là một tài nguyên cục bộ trên một Computer, nên Computer đang giữ repository đã được lập chỉ mục chính là nơi có sẵn graph “nóng” thay vì phải khởi động nguội mất ba phút. Agent là một cấu hình được lưu lại, nên thiết lập trong đó agent có chỉ mục và đúng quyền được tái sử dụng thay vì phải dựng lại trên từng máy. Và quá trình thực thi, các điểm tắc nghẽn, kết quả cùng phần thảo luận tiếp theo đều quay về dòng thời gian của task — nơi lưu giữ lý do đằng sau một thay đổi.
Sharkly không thay thế Claude Code, Codex hay codebase-memory-mcp. Nó bổ sung lớp task chia sẻ, Computer, context, kiểm soát và review bao quanh chúng. Việc sử dụng model vẫn diễn ra thông qua các gói đăng ký hoặc API key đã được cấu hình trong những công cụ đó.
Bộ nhớ về code cộng với bộ nhớ về công việc mới là sự kết hợp trọn vẹn. Một cái cho agent khả năng nhớ về repository. Cái còn lại cho team khả năng nhớ về những gì agent đã làm trong đó.
Khi nào cần cái nào
Hãy cài codebase-memory-mcp ngay từ bây giờ, bất kể quy mô team. Nó chạy cục bộ, không đòi hỏi thay đổi quy trình, và mức giảm chi phí mang lại lợi ích cho một developer cũng nhiều như cho hai mươi người.
Hãy thêm một hệ thống công việc chia sẻ khi phần lý giải cần tồn tại lâu hơn phiên làm việc: khi việc review diễn ra trước khi phát hành, khi có nhiều hơn một người cùng động vào một repository, hoặc khi ba tháng nữa sẽ có người hỏi vì sao một thay đổi được thực hiện. Graph sẽ trả lời code làm gì. Nó sẽ không bao giờ trả lời vì sao.
Agent nghiên cứu, thực thi, kiểm thử và báo cáo. Con người định hướng, trao quyền và chấp nhận kết quả.
Câu hỏi thường gặp
Nó có hoạt động với các agent khác ngoài Claude Code không? Có. Đây là một MCP server, nên bất kỳ MCP client nào cũng dùng được, và dự án liệt kê 45 bề mặt agent được hỗ trợ, bao gồm Cursor, Codex, Windsurf, OpenCode và Aider.
Code của tôi có rời khỏi máy không? Không. Toàn bộ quá trình xử lý diễn ra cục bộ, và dự án khẳng định nó không tự thực hiện bất kỳ yêu cầu mạng nào cũng như không kiểm tra cập nhật trong nền. Mã nguồn luôn có sẵn nếu bạn muốn tự kiểm chứng thay vì chỉ tin tưởng.
Mức giảm 99% token có thực tế không? Con số đó ứng với năm truy vấn cấu trúc, tức trường hợp tốt nhất. Con số đã qua bình duyệt trên 31 repository là ít hơn 10 lần token và ít hơn 2,1 lần lệnh gọi công cụ. Hãy tính toán dựa trên mức 10 lần.
Nó xử lý được repository lớn cỡ nào? Trường hợp giới hạn được nêu là nhân Linux với 28 triệu dòng trong ba phút. Các repository ứng dụng thông thường được lập chỉ mục trong vài mili giây.
Nó có hữu ích khi nhiều agent chạy cùng lúc không? Có, và hữu ích hơn mức thông thường. Năm agent cùng grep một repository là lãng phí gấp năm lần. Mỗi lần chạy Task vẫn có worktree riêng biệt, trong khi chỉ mục cấu trúc được chia sẻ trên Computer.
Tóm lại
Đây là công cụ ít được để ý nhất trong làn sóng 2026 và cũng là công cụ mang lại hiệu quả cao nhất. Chỉ một binary native duy nhất, không cần thay đổi quy trình, và cắt giảm được cả một bậc độ lớn lượng token mà agent phải tiêu tốn để trả lời những câu hỏi lẽ ra không cần phải grep. Hãy cài đặt, lập chỉ mục cho dự án của bạn, và mở trình xem graph một lần để thấy nó đã dựng nên những gì.
Sau đó, hãy hiểu rõ giới hạn. Nó nhớ repository chứ không nhớ công việc, và những quyết định đằng sau một thay đổi sẽ chết theo phiên làm việc trừ khi có thứ gì đó lưu giữ chúng. Sharkly làm được điều đó: Task là bản ghi chia sẻ, quá trình thực thi chạy trên các Computer bạn kết nối thông qua những runtime bạn đã trả tiền, và kết quả được trả về nơi một người có thể review và chấp nhận.
