agent-memory

What it does

• Markdown files are the source of truth; the SQLite FTS5 index is a deletable cache — nothing opaque to migrate off
• Recall returns an L0 list (one-line abstract, path, anchor, score) and mem read opens it at outline / abstract / full depth
• Three read tracks: deterministic MEMORY.md injection at session start, BM25 recall with an optional vector plugin fused by RRF, and plain ls/grep over the directory
• Writes fire at conversation boundaries and a sleep-time pass consolidates and forgets by value — all local, no API key

When to use it

For anyone whose coding agent forgets decisions between sessions: keep project decisions, preferences, and post-mortems in one store that Claude Code and Codex CLI both read and write, so the next session starts warm instead of from zero.

Getting started

# Requires Python 3.12+ and uv; no PyPI release yet
git clone https://github.com/tigerless-labs/agent-memory.git
cd agent-memory
uv sync --all-packages

mem init
# store defaults to ~/agent-memory-store;
# export AGENT_MEMORY_STORE to relocate it — in every shell your agents run in

Things to know

Version 0.1.0 and not on PyPI yet, so you are installing from a checkout — expect churn. The store path must be exported consistently in every environment your agents run in, or each one quietly gets its own store.