brain-cli — CLI bộ nhớ cục bộ gắn trí nhớ dài hạn cho Claude Code

Claude Code sẽ quên mọi thứ khi phiên làm việc kết thúc.
Bạn lại phải lần theo lỗi đã gặp từ 3 tuần trước, và thảo luận lại các quyết định kiến trúc đã đưa ra từ tháng trước.
Tôi cũng đã thử máy chủ MCP Memory, nhưng vấn đề là sự phụ thuộc vào đám mây và chất lượng tìm kiếm không ổn định.

Vì vậy, tôi đã triển khai trí nhớ dài hạn cho agent chỉ bằng các tệp Markdown cục bộ trong ~/Brain/.

---

Dùng trong các tình huống như sau:

① Phiên hôm nay, tiếp nối từ hôm qua
brain-cli recall -b -g "lỗi đăng nhập"
→ Khôi phục ngay chỗ đã bị mắc lại hôm qua và những gì đã thử

② Không debug cùng một lỗi hai lần
Nếu ghi lại triệu chứng + nguyên nhân + nội dung sửa
thì ở phiên sau, khi gặp lại cùng lỗi đó, recall sẽ hiển thị lời giải trước tiên

③ Các quyết định vẫn được ghi nhớ
Agent sẽ không hỏi lại những câu như "Tại sao dùng SQLite thay vì Redis?"
Bối cảnh của quyết định, các phương án đã xem xét và lý do lựa chọn đều được lưu lại thành các bản ghi có thể tìm kiếm

④ Nhiều instance Claude chia sẻ cùng một ký ức
Claude trong VS Code và Claude trên terminal cùng đọc và ghi vào một Brain giống nhau
Lỗi đã được sửa ở một bên sẽ không bị instance khác cố sửa lại lần nữa

⑤ Tích hợp với hooks trong CLAUDE.md thì hoàn toàn tự động
Chỉ cần thêm một dòng recall vào hook SessionStart
thì mỗi khi bắt đầu phiên, các ký ức liên quan sẽ được tự động khôi phục

---

npm install -g @ernham/brain-cli
Sau khi cài đặt, thư mục ~/Brain/ sẽ được tạo + tự động thêm routine recall vào CLAUDE.md

GitHub: https://github.com/ernham1/brain-cli | Giấy phép MIT | 87 bài kiểm thử