It keeps Markdown files as the source of truth while using a disposable local SQLite index for ranked retrieval. Agents search for file paths, read only the needed detail, and retain traceable session evidence. It supports one shared store across Claude Code, Codex CLI, Muse Code, and shell-capable agents.
For AI agent operators needing durable shared context, and agent integrators configuring MCP
Markdown memory files are authoritative, while SQLite and other indexes are rebuildable projections. All writes, including sleep-time management changes, pass through one Store validation and reindexing path so history, provenance, and indexes remain consistent.
CLAUDE.md (Invariants 1 and 2); packages/core/src/agent_memory/core/store.py (Store); packages/core/src/agent_memory/core/database.py (Database)
Store
Validates, persists, reads, traces, and reindexes memory records.
packages/core/src/agent_memory/core/store.py
Memory records
Serializes Markdown memories and manages validity intervals.
packages/core/src/agent_memory/core/record.py
Manage layer
Generates, reviews, applies, and reports sleep-time consolidation proposals.
packages/core/src/agent_memory/core/manage.py
Host hooks
Captures host events, injects memory, and launches distillation.
packages/adapters/src/agent_memory/adapters/hook_entry.py
Generated
