agent-memory
tigerless-labs
Markdown-based long-term memory runtime for AI agents with local ranked retrieval and a sleep-time consolidation layer.
What is agent-memory?
A memory runtime where plain markdown files in one store are the single source of truth, and a local SQLite index beside them is a disposable, rebuildable cache. Recall is local and ranked and answers with paths rather than pasted text; writes fire automatically at conversation boundaries; a sleep-time pass consolidates and forgets on its own clock, with deletions arriving only as proposals to confirm. Claude Code, Codex CLI and anything else that can run a shell command share the same store, with no API key required.
| Fact | Value |
|---|---|
| Maintainer | tigerless-labs |
| GitHub stars | 964 (as of 2026-09-23) |
| Forks | 63 |
| License | MIT |
| License type | OSI-open |
| Category | Agent memory and code knowledge |
| Status | Rising |
| Edition | 2026-09 |
| Last verified | 2026-09-23 |
agent-memory in depth
An agent that closes its session forgets everything it learned in it, and the two usual fixes both cost something: a vector-and-graph retrieval stack that hands back an opaque chunk you cannot inspect or migrate off, or a flat markdown filesystem that stays legible but stops ranking the moment the tree grows past a listing. agent-memory, built by tigerless-labs and released in September 2026, tries to be both at once. Plain markdown files under one store are the single source of truth; a local, rebuildable SQLite index sits beside them purely as a ranked-retrieval cache. Claude Code, Codex CLI and anything else that can shell out share the same store, so a decision recorded in one host is findable from another.
Retrieval answers with an L0 list, one line per hit with a path, abstract and score, and the agent opens only as deep as the task needs: outline, then full file, then the cited raw session transcript. Three independent read paths back each other up: deterministic injection of a root MEMORY.md at session start, BM25 full-text search over an FTS5 index, and, if both miss, the plain directory an agent can ls and grep by hand. Writes happen at conversation boundaries rather than depending on the agent remembering to record something, and an optional sleep-time pass consolidates and prunes on its own schedule, but only ever proposes deletions for a human to confirm, never deletes unattended.
The natural fit is a team standardizing memory across more than one coding-agent CLI that wants the store itself to stay auditable: every memory is a markdown file with frontmatter, diffable in git, greppable without any tool, and provably reconstructable, since deleting the index and rebuilding it is enforced by a test to lose nothing. No LLM client lives inside the library itself, so there is no API key to configure and no separate billing surface; the reasoning is borrowed from whichever host CLI is already running, which also means every write it makes is visible in that host's own transcript rather than happening invisibly.
The project is three weeks old at the time of writing, with no packaged release yet, so installing means cloning and running uv sync from source. Its own benchmark section is unusually careful about what it does not prove: the 120-episode LongMemEval-S study it reports is explicitly flagged as not comparable to published LongMemEval numbers, because the haystack is bounded to keep it a write-strategy study rather than a corpus-size one. Worth separately noting: the tigerless-labs organization has shipped a new open-source tool roughly every two to three weeks through 2026, and several of them reached thousands of stars within weeks of creation, a launch cadence and star velocity worth watching, even though the commit history here includes real externally authored pull requests fixing actual bugs.
agent-memory is worth a look if you run Claude Code and Codex side by side and want one inspectable, portable memory store behind both, rather than a black-box retrieval service. The engineering is more careful than the marketing suggests, the write-up owns its benchmark's limits rather than hiding them, but three weeks of history, no packaged release, and a fast-moving parent organization mean it is still a bet on a young project rather than a settled choice. Treat the retrieval-accuracy numbers as an interesting internal study, not an independent result, until the project or a third party reproduces them.
Pros & Cons
Pros
- Markdown files stay greppable, git-able and portable off the system; the SQLite index is a disposable, rebuildable cache (`rm -rf .index/ && mem rebuild` is enforced by a test to lose nothing)
- A real Manage layer with authority tiers: an unattended sleep pass may add and update, but deletion only ever arrives as a proposal you confirm
- No LLM client inside the library itself, so there is no API key to configure; judgment is borrowed from the host agent's own CLI, and every write stays visible in that host's transcript
Cons
- Only three weeks old (created 2026-09-01) and not on PyPI yet - install is git clone plus uv sync from a checkout
- The parent org (tigerless-labs) has shipped a new tool roughly every two to three weeks through 2026, several reaching hundreds to thousands of stars within weeks - a launch cadence worth watching, even though the commit history includes real externally authored PRs fixing actual bugs
- The 'proof it works' benchmark is the project's own 120-episode LongMemEval-S study with a bounded haystack, explicitly flagged by the project itself as not comparable to published LongMemEval scores
License
MIT (OSI-open)
When it is interesting
Teams standardizing memory across Claude Code and Codex CLI who want a plain-markdown store they can inspect, grep and migrate off at any time.
When it is too early
Anyone who needs a packaged release, a stable API, or independent verification of the retrieval-accuracy claims.
Commercial alternative & related
- Commercial counterpart: Mem0
This repo featured in the 2026-09 edition of the Open-Source AI Radar.
claude-mem
thedotmack
Persistent memory layer across agent sessions with automatic semantic summaries and token-cost transparency.
graphify
safishamsi
AI coding skill that turns a folder of code, docs and images into a queryable knowledge graph across 20+ agents.
memU
NevaMind-AI
Memory framework for proactive AI agents - typed memory graph from chats, docs and media.