Recall — Persistent Memory for Claude Code

Every Claude Code session starts from zero. Recall fixes that — conversations are automatically extracted, indexed, and searchable across sessions.

Opencode and Pi π are coming.

---

The Problem

Claude Code has no memory between sessions. Context is lost. You repeat yourself. Decisions made last week are forgotten today.

How Recall Fixes It

Install once, then forget about it. Recall runs silently in the background:

graph LR
    A[You Work] --> B[Session Ends]
    B --> C[Auto-Extract]
    C --> D[SQLite + FTS5]
    D --> E[Next Session]
    E -->|Memory Available| A

    style A fill:#3B82F6,color:#fff
    style C fill:#10B981,color:#fff
    style D fill:#F59E0B,color:#fff

Loading

• Auto-extraction — sessions are parsed into structured summaries when they end
• Full-text + semantic search — find anything from any past session
• Zero friction — no workflow changes, no manual steps
• MCP integration — Claude Code searches your memory automatically

Quick Start

git clone https://github.com/edheltzel/Recall.git
cd Recall
./install.sh

Verify it works:

mem stats        # Database overview
mem doctor       # Health check

Restart Claude Code to load the MCP server and hooks.

Full installation guide — prerequisites, platform support, session extraction setup

What You Get

• Session memory — auto-extracted on every session end via Claude Haiku
• Full-text + semantic search — FTS5 keyword search, Ollama vector embeddings, or hybrid with Reciprocal Rank Fusion
• Decision & learning tracking — record architectural decisions with reasoning, capture problems solved
• Agent context — spawned agents inherit relevant memory via context_for_agent
• Library of Alexandria — curated knowledge entries with Fabric extract_wisdom analysis
• Breadcrumbs — quick context notes for future sessions

CLI at a Glance

mem "kubernetes auth"          # Search your memory
mem dump "Session Title"       # Save this session
mem add decision "Use X" ...   # Record a decision
mem stats                      # See what's stored
mem doctor                     # Health check

Full CLI reference

For AI Agents

If you're an AI agent reading this repository:

What you need	Where to find it
Using Recall (MCP tools, CLI, core rules)	FOR_CLAUDE.md
Developing Recall (build, test, conventions)	CLAUDE.md

Documentation

Guide	Description
Installation	Prerequisites, install, verify, session extraction
CLI Reference	All commands and options
MCP Tools	Tools available to AI agents
Architecture	Database, search, extraction pipeline
Slash Commands	/recall:* commands for Claude Code
Upgrading	Update, backup, migration system
Troubleshooting	Common issues and fixes

License

MIT