​

Claude-Mem

​

Quick Start

npx claude-mem install

/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem

​

Key Features

• 🧠 Persistent Memory - Context survives across sessions
• 📁 Folder Context Files - Auto-generated CLAUDE.md in project folders with activity timelines
• 🌐 Multilingual Modes - Writes memory in 30 languages: English plus 29 others (Spanish, Chinese, French, Japanese, etc.)
• 🎭 Mode System - Switch between workflows (Code, Email Investigation, Chill)
• 🔍 MCP Search Tools - Query your project history with natural language
• 🧠 Knowledge Agents - Build queryable “brains” from your observation history
• 🌐 Web Viewer UI - Real-time memory stream visualization served by the local worker
• 🔒 Privacy Control - Use <private> tags for manual blocks, or enable auto-redaction for regex-based secret detection.
• ⚙️ Context Configuration - Fine-grained control over what context gets injected
• 🤖 Automatic Operation - No manual intervention required
• 📊 FTS5 Search - Fast full-text search across observations
• 🔗 Citations - Reference past observations with IDs

​

How It Works

┌─────────────────────────────────────────────────────────────┐
│ Session Start → Inject context from last 10 sessions       │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│ User Prompts → Create session, save user prompts           │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│ Tool Executions → Capture observations (Read, Write, etc.)  │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│ Worker Processes → Extract learnings via Claude Agent SDK   │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│ Session Ends → Generate summary, ready for next session     │
└─────────────────────────────────────────────────────────────┘

1. 5 Lifecycle Hooks - SessionStart, UserPromptSubmit, PostToolUse, Summary (Stop), SessionEnd
2. Worker Service - Express HTTP API managed by Bun on a per-user port (default 37700 + (uid % 100))
3. SQLite Database - Stores sessions, observations, summaries with FTS5 search
4. Chroma Vector Index - Optional embedding-based semantic search
5. MCP / Skill Search Tools - Query historical context with natural language
6. Web Viewer UI - Real-time visualization with SSE and infinite scroll

​

System Requirements

• Node.js: 20.0.0 or higher
• Bun ≥ 1.0 (auto-installed by npx claude-mem install if missing)
• uv (auto-installed if missing — provides Python for Chroma)
• Claude Code (or another supported IDE: Cursor, Windsurf, OpenCode, Codex CLI, Antigravity CLI, OpenClaw)
• SQLite 3 — bundled via bun:sqlite

​

Next Steps