Skip to content

mempal v0.1.0 — Project memory for coding agents

Latest

Choose a tag to compare

@ZhangHanDong ZhangHanDong released this 11 Apr 20:10
· 177 commits to main since this release

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 mempal

Quick Start

mempal init ~/code/myapp
mempal ingest ~/code/myapp --wing myapp
mempal search "auth decision clerk"
mempal wake-up

Architecture

  • 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