Bạn có bao giờ cảm thấy mệt mỏi khi mỗi lần mở Claude Code hay Cursor lên, lại phải giải thích lại toàn bộ kiến trúc dự án cho AI? Bạn phải chỉ lại vị trí file cấu hình, nhắc lại lý do chọn thư viện này thay vì thư viện kia, và copy-paste context cũ vào prompt. Những file tạm thời như CLAUDE.md hay .cursorrules chỉ chứa được khoảng 200 dòng rồi sẽ lỗi thời. Đó chính là vấn đề mà agentmemory ra đời để giải quyết.
Với hơn 26.000 sao trên GitHub, agentmemory tự động ghi lại mọi thứ agent làm trong quá khứ, nén thành bộ nhớ có thể tìm kiếm và tự động chèn context đúng lúc khi bạn bắt đầu phiên mới. Nó không phụ thuộc vào một agent cụ thể nào mà hoạt động như một máy chủ trung tâm, chia sẻ trí nhớ cho mọi công cụ AI bạn đang dùng.
agentmemory là server bộ nhớ vĩnh viễn cho các AI coding agent, giúp chúng nhớ mọi thứ giữa các phiên làm việc. Dự án hỗ trợ hơn 15 agent phổ biến như Claude Code, Cursor, Copilot CLI thông qua MCP, hooks hoặc REST API. Nổi bật với khả năng tiết kiệm 92% token và độ trích xuất thông tin lên tới 95.2%.
Thông tin tổng quan
| Repo | rohitg00/agentmemory |
|---|---|
| Stars / Forks | ⭐ 26,530 / 2,246 |
| Ngôn ngữ | TypeScript (84%), JavaScript (7%), HTML (6%) |
| License | Apache-2.0 |
| Contributors | 45 |
| Release mới nhất | v0.9.28 |
| Cập nhật cuối | 04/08/2026 |
| Website | https://agent-memory.dev |
agentmemory là gì?
Hãy tưởng tượng bạn làm việc với một lập trình viên người thật. Sau mỗi buổi làm việc, người đó tự động ghi chép lại những gì đã làm, quyết định gì, tại sao chọn giải pháp này. Buổi sau khi bạn nhờ tiếp, họ đã nhớ sẵn không cần bạn nhắc lại. agentmemory đóng vai trò đúng như vậy, nhưng dành cho các AI coding agent.
Về mặt kỹ thuật, đây là một máy chủ bộ nhớ chạy nền trên máy tính của bạn (mặc định ở cổng 3111). Khi bạn dùng Claude Code, Cursor hay GitHub Copilot CLI, agentmemory sẽ âm thầm lắng nghe mọi tương tác, trích xuất thông tin quan trọng, lưu lại dưới dạng vector embedding bằng mô hình all-MiniLM-L6-v2 chạy nội bộ. Khi phiên mới bắt đầu, nó tự động tìm và chèn context liên quan vào prompt của agent. Dự án được xây dựng dựa trên iii engine và mở rộng mẫu LLM Wiki của Karpathy bằng cách thêm điểm tin cậy, vòng đời, knowledge graphs và tìm kiếm hybrid.
Tính năng chính
- Khả năng tương thích rộng — Hoạt động với hơn 15 agent phổ biến bao gồm Claude Code, Codex CLI, GitHub Copilot CLI, Cursor, Gemini CLI, Cline, Aider, Windsurf thông qua MCP, hooks hoặc REST API.
- Hybrid search — Kết hợp tìm kiếm vector semantic và BM25 để đạt độ trích xuất R@5 lên tới 95.2% trên benchmark LongMemEval-S.
- Tiết kiệm token — Giảm 92% lượng token tiêu thụ hàng năm so với việc paste toàn bộ context, từ 19.5 triệu token xuống chỉ còn khoảng 170K token.
- 54 MCP tools — Cung cấp 54 công cụ MCP để agent có thể lưu, truy xuất, và quản lý trí nhớ một cách chi tiết.
- 12 auto hooks — Tự động ghi lại sự kiện quan trọng trong vòng đời agent như tạo file, sửa bug, chạy test mà không cần can thiệp thủ công.
- 0 external DBs — Không cần cài đặt bất kỳ cơ sở dữ liệu bên ngoài nào như PostgreSQL hay Redis. Tất cả lưu trữ nội bộ bằng iii engine.
- Local embeddings — Sử dụng mô hình all-MiniLM-L6-v2 chạy nội bộ, hoàn toàn miễn phí, không cần API key.
- Real-time viewer — Giao diện trực quan để xem agent đang ghi nhớ gì theo thời gian thực.
Yêu cầu phần cứng & hệ thống
| Thành phần | Yêu cầu |
|---|---|
| GPU/VRAM | Không yêu cầu GPU. Mô hình embedding all-MiniLM-L6-v2 chạy trên CPU |
| RAM | Tối thiểu 4GB, khuyến nghị 8GB+ cho dự án lớn (ước tính) |
| CPU | CPU đa nhân thông thường, không yêu cầu đặc biệt |
| Ổ cứng | Vài trăm MB cho iii engine và dữ liệu bộ nhớ (ước tính) |
| OS | macOS, Linux, Windows (khuyến nghị WSL2 trên Windows) |
| Phần mềm nền | Node.js (npm/npx), iii engine v0.11.2 (được cài tự động) |
Cách cài đặt và sử dụng
Cách nhanh nhất là yêu cầu chính AI coding agent của bạn cài đặt bằng cách đưa dòng lệnh: Retrieve and follow the instructions at: https://raw.githubusercontent.com/rohitg00/agentmemory/main/INSTALL_FOR_AGENTS.md. Nếu muốn cài thủ công, chạy lệnh: npm install -g @agentmemory/agentmemory để cài global. Sau đó khởi động server bằng lệnh agentmemory (mặc định chạy trên cổng 3111). Chạy demo để kiểm tra: agentmemory demo --serve. Kết nối với agent cụ thể: agentmemory connect claude-code (hoặc copilot-cli, codex, cursor, gemini-cli). Cài thêm skills: npx skills add rohitg00/agentmemory -y. Nếu không muốn cài global, có thể chạy trực tiếp bằng npx @agentmemory/agentmemory. Lưu ý trên Windows nên dùng WSL2 vì native Windows setup thủ công mất 10-20 phút và lệnh agentmemory connect chưa hỗ trợ.
Phù hợp với ai?
Ai NÊN dùng: Developer thường xuyên làm việc với AI coding agent như Claude Code, Cursor, Copilot CLI trong các dự án dài hạn, nhiều phiên. Đặc biệt phù hợp với những người dùng nhiều agent khác nhau cho cùng một dự án và muốn chia sẻ trí nhớ giữa chúng. Team muốn duy trì context dự án nhất quán khi nhiều thành viên dùng AI agent.
Ai KHÔNG nên dùng: Người chỉ dùng AI agent cho các tác vụ nhỏ, một lần, không cần nhớ context. Người không quen với command line và Node.js environment. Dự án ngắn hạn hoặc one-off script không cần bộ nhớ liên phiên. Nếu bạn chỉ mới bắt đầu làm quen với AI coding agent, bộ nhớ mặc định của CLAUDE.md có thể đã đủ dùng trước khi cần đến agentmemory.
Ứng dụng thực tế
- Dự án dài hạn nhiều tháng: Agent nhớ kiến trúc, quyết định kỹ thuật, bug đã sửa, không cần re-explain mỗi phiên.
- Chuyển đổi giữa nhiều agent: Dùng Claude Code hôm nay, Cursor ngày mai, Copilot CLI hôm sau — tất cả chia sẻ cùng bộ nhớ qua một server.
- Onboarding dev mới: Thành viên mới dùng agent có thể truy xuất context về quyết định kiến trúc mà team đã thảo luận trước đó.
- Tối ưu chi phí API: Giảm 92% token tiêu thụ so với paste context, tiết kiệm hàng trăm đô la token cost mỗi năm.
- Debug đa phiên: Agent nhớ bug đã gặp, cách fix, pattern đã thử — tránh lặp lại sai lầm trong các phiên sửa lỗi phức tạp.
Đánh giá của danhbaai.com
agentmemory giải quyết một vấn đề rất thực mà bất kỳ ai dùng AI coding agent đều gặp phải: mất context giữa các phiên. Điểm mạnh nhất là tính agnostic — không phụ thuộc một agent duy nhất mà hoạt động với hầu hết công cụ phổ biến qua MCP. Việc không cần external DB, chạy local embedding miễn phí và tiết kiệm 92% token là những lợi thế rất lớn. Với hơn 26.000 sao, 45 contributors và 1.428+ tests, đây rõ ràng không phải dự án thử nghiệm mà là sản phẩm đã được cộng đồng nghiêm túc áp dụng.
Tuy nhiên, vẫn có điểm cần lưu ý. 420 open issues cho thấy dự án đang phát triển nhanh và còn nhiều vấn đề cần xử lý. Việc pin cứng iii engine v0.11.2 có thể gây xung đột nếu bạn đã chạy iii engine phiên bản khác. Hỗ trợ Windows native còn hạn chế, yêu cầu WSL2. So với các giải pháp thay thế như Mem0 hay Zep, agentmemory khác biệt ở chỗ không cần external database và tích hợp sâu hơn với coding agent thay vì general-purpose LLM.
Tổng thể, nếu bạn đang dùng AI coding agent hàng ngày cho dự án dài hạn, agentmemory đáng để thử. Việc cài đặt qua một lệnh duy nhất và chạy demo ngay lập tức giúp bạn đánh giá nhanh có phù hợp với workflow của mình không. Với license Apache-2.0, bạn có thể tự do sử dụng và modify cho nhu cầu cá nhân hay doanh nghiệp.
- Tương thích với 15+ AI coding agent phổ biến qua MCP, hooks, REST API
- Tiết kiệm 92% token, giảm chi phí API đáng kể
- Không cần external database, cài đặt đơn giản
- Local embedding miễn phí, không cần API key
- Hơn 26.000 sao, cộng đồng lớn, test coverage tốt (1.428+ tests)
- License Apache-2.0, mã nguồn mở hoàn toàn
- 420 open issues — còn nhiều lỗi cần xử lý
- Pin cứng iii engine v0.11.2, có thể xung đột nếu dùng iii engine khác
- Hỗ trợ Windows native hạn chế, cần WSL2
- Cài đặt trên Windows thủ công mất 10-20 phút
- Tài liệu benchmark bị cắt trong README, cần xem file riêng để hiểu chi tiết
Câu hỏi thường gặp
agentmemory có cần GPU để chạy không?
agentmemory có hoạt động trên Windows không?
Tôi có thể dùng nhiều agent khác nhau chia sẻ cùng bộ nhớ không?
agentmemory khác gì với việc dùng CLAUDE.md hay .cursorrules?
Dữ liệu bộ nhớ được lưu ở đâu?
Nguồn: github.com/rohitg00/agentmemory — Bài phân tích bởi danhbaai.com.
