TL;DR

brain là một memory layer portable cho AI agent, dùng git làm nguồn và SQLite FTS5 làm index.

Một note lưu trong Claude Code sẽ ngay lập tức xuất hiện khi bạn mở Cursor, Codex, hay Hermes - không cần cấu hình thêm, không cần server riêng.

Truy vấn trả về top-5 kết quả trong dưới 1ms trên 100,000 sự kiện. Miễn phí, offline hoàn toàn, một binary trên PATH.

Vấn đề mà mọi AI builder đang bỏ qua

Harrison Chase (CEO LangChain) đã nói thẳng vào tháng 4/2026: "memory sẽ là điểm khóa vĩ đại. Mọi người đều biết điều này, vì vậy đang lao vào chiếm lĩnh trước. Memory phải được mở!"

Taranjeet từ Mem0 đẩy xa hơn một bước: không chỉ model mới cần swappable - context giúp agent hữu ích cũng phải portable.

Memory lock-in còn nguy hiểm hơn model lock-in, vì khi bạn đổi tool hay model, bạn mất đi thứ không thể tái tạo: lịch sử quyết định, sở thích cá nhân, cách làm việc đặc thù.

Đây là nghịch lý mà hầu hết AI builder đang mắc: họ dành thời gian xây model, chọn vector DB, tối ưu prompt - nhưng để memory bị nhốt trong một platform cụ thể.

Khi Anthropic ra Claude Managed Agents, OpenAI tích hợp Codex với compaction summary mã hóa không tương thích ngoài hệ sinh thái - memory của bạn theo đó mà biến mất.

F5871E8B-132C-4A8C-8F3B-08D8F5BFDFBC.png

brain là gì và nó giải quyết bài toán đó như thế nào

brain (github.com/codejunkie99/brain) là một memory layer viết bằng Rust, kiến trúc gồm hai phần tách biệt:

  • Git làm nguồn sự thật: Mỗi note là một commit. Audit log miễn phí. Sync qua brain push/brain pull dùng hạ tầng git sẵn có - SSH key, HTTPS credential, macOS Keychain đều hoạt động mà không cần cấu hình thêm.

  • SQLite FTS5 làm index: Git chậm khi search. SQLite nhanh. Index là disposable - bị hỏng thì chạy brain doctor --deep để rebuild từ git trong vài giây. Nguồn sự thật duy nhất vẫn là git log.

Kết nối với agent qua MCP stdio server, exposing 5 tools. Adapter có sẵn cho Claude Code, Cursor, Codex, OpenClaw, Hermes. Một binary trên PATH, không daemon, không service riêng.

A604E874-FF2E-4319-B4E7-A20D6AEFD3CB.png

Kỹ thuật đằng sau - những con số quan trọng

Dự án được xây trong 9 tuần, khoảng 9,000 dòng Rust, 143 regression tests từ 13 vòng adversarial review.

Thiết kế nổi bật:

  • 10 loại event có typed schema: Observe, Claim, Lesson, Pref, SkillEdit, Verify, Archive, Redact, Import, Audit - mỗi loại có retrieval rule và visibility riêng. Typed memory = queryable memory, không phải markdown blob không thể inspect.

  • Redact rollback thay vì xóa: Khi redact một Pref, hệ thống phục hồi giá trị tiền nhiệm - như git revert nhưng cho memory.

  • Secret prefilter 3 lớp: 18 pattern, NFKC normalization, zero-width stripping - chặn cả cách obfuscate dùng zero-width space.

  • Two-phase write: commit git trước (durable, ~10ms), ingest SQLite sau (fast, ~1ms). Nếu process chết giữa chừng, catch_up_index tự reconcile lần khởi động tiếp.

Một insight quan trọng từ quá trình build: mô tả tool quan trọng hơn implementation.

Tool description chỉ ghi "Lưu note" sẽ không bao giờ được agent tự gọi. Đổi thành "CALL THIS WHENEVER: user states a preference..." - agent bắt đầu dùng proactive, không cần nhắc.

F8F87828-79EA-4C60-B383-4B04A409146F.png

So sánh với các lựa chọn khác

Metric

brain (SQLite+FTS5)

Pinecone Free

Mem0

Latency truy vấn

<1ms

50-200ms

0.71-1.09s

Chi phí

$0

$0-70/tháng

Free (self-hosted)

Offline

Có

Không

Có (OpenMemory)

Setup

0 phút

15 phút

pip install

Scale target

1 user, ≤100k events

Enterprise

Enterprise

Mem0 vừa ra thuật toán mới (tháng 4/2026) đạt 91.6 trên LoCoMo benchmark (+20 điểm so với phiên bản cũ), nhưng vẫn cần LLM call (~7K tokens/lần). brain không dùng embedding, không cần API key - BM25 trên FTS5 cho kết quả retrieval không thua kém với dưới 100,000 sự kiện của một người dùng.

523BE905-D901-4573-AA5E-2682F099734F.png

Ai nên cài đặt ngay hôm nay

Lý tưởng cho:

  • Developer dùng nhiều AI tool song song (Claude Code + Cursor + Codex) và muốn memory nhất quán giữa các tool - note lưu ở tool này, tool kia đọc được ngay

  • Team cần data residency hoặc làm việc với code nhạy cảm - không muốn memory gửi lên cloud bên thứ ba

  • Người đang lo lắng về việc bị khóa vào một platform AI cụ thể khi model thay đổi hoặc pricing tăng

Chưa phù hợp nếu: bạn cần multi-user memory, scale enterprise, hoặc retrieval ngữ nghĩa phức tạp qua embedding - khi đó Mem0 hoặc LangChain Deep Agents là lựa chọn tốt hơn.

Cài đặt & nguồn tham khảo

Cài đặt từ github.com/codejunkie99/brain, sau đó dùng brain note để lưu và brain ask để tìm kiếm từ bất kỳ terminal nào. Adapter có sẵn tích hợp với hầu hết AI coding tool phổ biến qua MCP config. Sync giữa máy qua brain push/brain pull - không cần gì thêm ngoài một git remote.

Nguồn: github.com/codejunkie99/brain, Harrison Chase - Your harness, your memory, Mem0 - State of AI Agent Memory 2026.