ErebusEnigma/context-memory

Persistent, searchable context storage across Claude Code sessions using SQLite + FTS5.
Table of Contents
- Why?
- Features
- Architecture
- Installation
- Uninstalling
- Requirements
- Commands
- How It Works
- Usage Examples
- Trigger Phrases
- Web Dashboard
- CLI Tools
- Database Management
- Testing
- Contributing
- License
- Author
Why?
Claude Code sessions are **ephemeral** - every conversation starts from zero. Close the terminal and everything you discussed, decided, and solved is gone. The only way to get that context back is to re-explain it or hope Claude reads the right files.
**context-memory fixes this.**
- **"How did we fix that auth bug last week?"** - Instead of re-debugging, /recall authentication pulls up exactly what you did, what you decided, and why.
- **Decisions have context** - You chose JWT over sessions for a reason. Three months later, you can't remember why. Your past sessions can.
- **Code patterns survive sessions** - That elegant retry pattern you built? It's saved with the language, file path, and description of what it does. /recall retry pattern --detailed brings it back.
- **Projects you haven't touched in months** - /recall --project scopes to whatever you're working in. Instant refresher on where you left off.
- **Cross-project learning** - Solved a CORS issue in one project? When it hits another, /recall CORS finds it regardless of which project it came from.
- **Sub-50ms search** - It's SQLite with FTS5 and tuned PRAGMAs (WAL mode, 64MB cache, in-memory temp store). Searching thousands of sessions feels instant.
- **Two words to save everything** - /remember and Claude does the rest: summarizes, extracts topics, identifies key code, stores it all. Add a note if you want, or don't.
Without it, every session is a blank slate. With it, Claude Code has a long-term memory that grows more valuable the more you use it.
Features
**Core:**
- **Cross-session memory** - Save and recall past work across Claude Code sessions
- **Structured AI summaries** - /remember generates rich summaries with brief/detailed text, key decisions, problems solved, technologies used, and outcome classification (success/partial/abandoned)
- **Full-text search** - FTS5 with Porter stemming for fast, fuzzy search
- **Two-tier retrieval** - Summary-ranked search with multi-source boost ( **Note**: The hooks use Python wrappers (auto_save.py, pre_compact_save.py) and work cross-platform — Windows (CMD, PowerShell), macOS, and Linux.
Uninstalling
This removes the skill, commands, hooks (both Stop and PreCompact), and MCP server registration. Your saved sessions are preserved by default. Use --remove-data to also delete the database, or --keep-data to skip the prompt. Use --force to remove command files even if they've been modified.
Requirements
- Python >= 3.8
- SQLite with FTS5 support (included in Python's standard library)
- MCP server (optional): Python >= 3.10 and pip install mcp
- Web dashboard (optional): pip install flask flask-cors
Commands
/remember [note]
Save the current session to context memory.