agent-memory is a local-first, agent-agnostic long-term memory runtime for AI agents. It stores memories as plain Markdown files, with a rebuildable SQLite index used as a cache rather than the source of truth. Conversation-boundary hooks trigger writes, while an independent sleep-time Manage pass consolidates, ages, and forgets memories by value; unattended deletion is limited to proposals that require confirmation, and superseded or archived material remains available.
The runtime provides three recall paths: deterministic MEMORY.md injection at session start, BM25 search with progressive disclosure, and direct access through the store's directory tree using tools such as ls and grep. Memory records use frontmatter for names, abstracts, status, timestamps, links, weights, and provenance, with free-form Markdown bodies. Its CLI, MCP server, and host-agent hooks share the same validation, hash-diff, and reindexing path, and it can be used by agents that run shell commands, including Claude Code and Codex CLI.
The repository documents a Python 3.12-or-later setup using uv, commands for initialization, recording, recall, rebuilding, sleep-time consolidation, and proposal approval, plus host setup for Claude Code and Codex. It does not include an LLM client; reasoning is delegated to the host agent's CLI, so the library requires no separate model keys or billing surface.