What is mempal?
Single binary project memory for coding agents. cargo install mempal, find past decisions with citations in seconds.
Key Features
- Hybrid search: BM25 + vector + RRF fusion
- Knowledge graph: temporal triples (add/query/invalidate/timeline/stats)
- Cross-wing tunnels: automatic cross-project knowledge discovery
- Self-describing protocol: 9 behavioral rules embedded in MCP ServerInfo
- Multilingual: model2vec-rs (BGE-M3 distilled), zero native dependencies
- 7 MCP tools: status, search, ingest, delete, taxonomy, kg, tunnels
- AAAK compression: BNF grammar + jieba Chinese word segmentation
- Safety: soft-delete, audit logging, semantic dedup warnings
- 5 ingest formats: Claude JSONL, ChatGPT JSON, Codex CLI, Slack DM, plain text
- Agent diary: cross-session behavioral learning (Rule 5a)
- Auto-dream integration: memory consolidation with Claude Code
Install
cargo install mempalQuick Start
mempal init ~/code/myapp
mempal ingest ~/code/myapp --wing myapp
mempal search "auth decision clerk"
mempal wake-upArchitecture
- Storage: SQLite + sqlite-vec, single file
~/.mempal/palace.db - Embedding: model2vec (default, 256d multilingual) or ONNX (optional, 384d)
- Search: BM25 (FTS5) + vector + RRF(k=60) + Wing/Room routing + tunnel hints
- Schema: v4 (importance ranking, soft-delete, FTS5 triggers, triples)
- Binary: 8.5MB (LTO + strip + opt-level=z)
Links
- crates.io
- Design docs
- Usage guide
- Benchmark results
- Book: MemPalace — Reforging Memory in Rust (Part 10, Chapters 26-30)