It finds signal in the noise. Your AI sees thousands of messages. TrueMemory figures out which ones actually matter and throws away the rest. No manual tagging, no prompt engineering. It just knows.
It gets sharper over time. It's not a static database. It's a living memory that grows with you. It resolves contradictions when you change your mind, updates stale facts, and consolidates what it knows. The longer you use it, the better it gets.
The memory your AI should have had from the start. Automatic capture, automatic recall, 100% local. One SQLite file, zero cloud. Works with Claude Code, Claude CLI, Cursor, Codex CLI, Gemini CLI.
2026-10-26
Estrellas
382
Herramientas
—
Disponibilidad
—
It works without you thinking about it. TrueMemory automatically captures memories from your conversations and automatically injects the right ones into your next session. You never have to store or search for anything manually. It just happens.
It's 100% local. One SQLite file on your machine. Your memories never leave your device. No cloud, no API keys needed. Your data is yours. (Anonymous usage telemetry is the only exception — never memory content — and one env var turns it off. Details.)
Without TrueMemory: "What framework are we using?" Asked for the 12th time this week. Your agent starts every session with amnesia. It doesn't know your name, your stack, or anything you told it yesterday.
With TrueMemory: Your agent already knows you use FastAPI, prefer Pydantic v2, and that your auth middleware lives in src/auth/. It remembers your corrections, your preferences, and your decisions. Across every session, forever.
How TrueMemory Compares
System
LoCoMo
LongMemEval
Local-first
Auto-capture
License
TrueMemory Pro
93.0%
92.0%
✅
✅
AGPL-3.0
TrueMemory Base
92.0%
84.1%
✅
✅
AGPL-3.0
Mem0
61.4%
—
Partial
❌
Apache-2.0
Supermemory
65.4%
—
❌
❌
Cloud API
MemOS
75.8%
—
✅
❌
Apache-2.0
ReadAgent
79.5%
—
❌
❌
Research
All benchmarks independently reproducible. Scripts included in benchmarks/.
Quick Start
For Claude Code / Claude CLI / Cursor / Codex CLI / Gemini CLI
curl -LsSf https://raw.githubusercontent.com/buildingjoshbetter/TrueMemory/main/install.sh | sh
Installs everything in an isolated environment. Downloads ~1.5GB of AI models. No data leaves your machine. No sudo required.
Open a terminal: Mac: Cmd + Space, type Terminal. Linux: Ctrl + Alt + T. Windows: open PowerShell.
Paste the command above and press Enter.
Wait 3-5 minutes for models to download.
Quit your AI tool completely and reopen it (Mac: Cmd+Q).
from truememory import Memory
m = Memory()
m.add("Prefers dark mode and TypeScript", user_id="alex")
print(m.search("preferences", user_id="alex"))
Tiers
Same architecture, three tiers. All included in a single install. Switch anytime by saying "switch to Pro" or "switch to Base."
Edge
Base
Pro
LoCoMo
89.6%
92.0%
93.0%
LongMemEval
—
—
92.0%
BEAM-1M
—
—
76.6% (SOTA)
Embedding model
8 MB lightweight
600 MB high-accuracy
600 MB high-accuracy
Reranker
22M params
149M params
149M params
HyDE search
—
—
✅ (requires LLM API key)
Runs on
Any machine, CPU only
4 GB+ RAM
4 GB+ RAM + API key
Edge works everywhere. Base is the strongest fully-offline tier. Pro adds AI-powered query expansion for the highest scores.
Benchmarks
Tested across three major benchmarks with all systems sharing the same answer model (GPT-4.1-mini), judge (GPT-4o-mini, 3x majority vote), and scoring pipeline.
All benchmarks use the same eval pipeline. Nothing is hidden. Full details: LoCoMo | LongMemEval | BEAM
Works With
Lifecycle hooks capture conversations automatically. No manual work needed. Your memories stay local in a single SQLite file.
Python API
from truememory import Memory
m = Memory()
m.add("Prefers dark mode and TypeScript", user_id="alex")
m.add("Works at Anthropic as a senior engineer", user_id="alex")
m.add("Always sign commits with GPG", directive=True) # directives auto-load every session
results = m.search("What are Alex's preferences?", user_id="alex")
results = m.search_deep("career history?", user_id="alex") # multi-round, higher accuracy
Method
Description
m.add(content, user_id)
Store a memory (directive=True for standing instructions that auto-load at the start of every session)
Everything lives locally in ~/.truememory/memories.db. Edge and Base tiers make zero external calls. Pro sends only your search query text to an LLM for query expansion. Your memories are never transmitted.
No. The installer uses uv to manage a sandboxed Python 3.12. Your system Python is never touched.
Context windows are expensive, slow, and empty at the start of every session. TrueMemory gives instant recall for zero tokens of context, in under 200ms.
Anonymous usage telemetry (tool calls, session counts, platform info) is on by default. We never track memory content, queries, file paths, or API keys. Opt out: export TRUEMEMORY_TELEMETRY=off
Get Started in 60 Seconds
For Claude Code, Claude CLI, Cursor, Codex CLI, or Gemini CLI:
curl -LsSf https://raw.githubusercontent.com/buildingjoshbetter/TrueMemory/main/install.sh | sh
Using it as a Python library instead? pip install truememory
@article{sauronlabs2026storage,
title = {Storage Is Not Memory: A Retrieval-Centered Architecture for Agent Recall},
author = {Sauron Labs},
journal = {arXiv preprint arXiv:2605.04897},
year = {2026},
url = {https://arxiv.org/abs/2605.04897}
}
AGPL-3.0. Free for personal and research use. Commercial use requires a separate license. Contact [email protected].
T
TrueMemory
buildingjoshbetter·382 estrellas·
The memory your AI should have had from the start. Automatic capture, automatic recall, 100% local. One SQLite file, zero cloud. Works with Claude Code, Claude CLI, Cursor, Codex CLI, Gemini CLI.
Aún no hay lista de herramientas. Los servidores remotos la reciben tras la primera comprobación de estado.
Preguntas frecuentes
Preguntas
¿Cómo instalo TrueMemory?
Copia en esta página la configuración stdio para Cursor, Claude Desktop, Claude Code o VS Code. Usa la instalación del publicador, no un proxy de PlugMCP.
¿TrueMemory necesita una clave de API?
Este registro no indica ninguna variable de entorno obligatoria.
¿Qué transporte usa TrueMemory?
TrueMemory se ejecuta localmente por stdio.
¿Cuándo se comprobó TrueMemory por última vez?
Última comprobación: 2026-10-26. The memory your AI should have had from the start. Automatic capture, automatic recall, 100% local. One SQLite file, zero cloud. Works with Claude Code, Claude CLI, Cursor, Codex CLI, Gemini CLI.