mem0-memory-layer
Auto-generated from project docs
North Star
Booklet Status
| Booklet | Status | Branch | Notes |
|---|---|---|---|
| B0 | COMPLETE | N/A | Cleanup — MEMORY.md 206→89 lines, 5 topic files, dead systems removed |
| B1 | COMPLETE | booklet/mem0-memory-layer-b1 | Mem0 1.0.9 + pgvector + MCP server + 31 memories seeded |
| B2 | NOT STARTED | booklet/mem0-memory-layer-b2 | Min Min + HAA integration + migration |
| B3 | NOT STARTED | booklet/mem0-memory-layer-b3 | Pruning, monitoring, cross-agent validation |
| ID | Type | Deliverable | Priority |
| ---- | ------ | ------------- | ---------- |
| B0-D1 | deliverable | MEMORY.md rewritten as pure 89-line index | P0 |
| B0-D2 | deliverable | 5 new topic files created | P0 |
Recent Decisions
| Date | Decision | Rationale |
|---|---|---|
| ------ | ---------- | ----------- |
| 2026-03-30 | Project kickstarted | 5 fragmented memory systems, multiple failed prior attempts, industry moving to shared memory layers |
| 2026-03-30 | Mem0 over custom build | 48K stars, Apache 2.0, native pgvector/Supabase support, 26% accuracy boost. Why reinvent? |
| 2026-03-30 | B0 cleanup before B1 | Risk analysis: adding 5th memory system on top of 4 broken ones = worse. Clean first. |
| 2026-03-30 | HAA read-only initially | Risk: autonomous agent writing bad memories propagates to all agents. Validate first. |
| 2026-03-30 | Gemini embeddings over local model | Free tier covers volume (~200 ops/day). Saves ~1-2GB RAM vs Ollama. Fallback: OpenAI key in .env. |
| 2026-03-30 | Embeddings through LiteLLM | Security rule (INCIDENT-016): all AI API calls must route through LiteLLM proxy. |
| 2026-03-30 | MCP stdio not systemd | Claude Code spawns MCP servers via stdio. No persistent process needed for Claude Code access. systemd only if Min Min/HAA need HTTP API. |
| 2026-03-30 | OPENROUTER_API_KEY must be excluded | Mem0's OpenAI LLM checks OPENROUTER_API_KEY first, bypasses LiteLLM. config.py only loads required keys + explicitly removes OPENROUTER. |
| 2026-03-30 | Port 5433 not 5432 | pgBouncer on 5432 returns "Tenant or user not found". Port 5433 is direct DB access. |
Source: /root/projects/mem0-memory-layer/