The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
TrueMemory
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,…
Install
pip install truememoryInstall command taken from the project's README or registry entry. Always review code before running it.
README excerpt
Read full README on GitHub →–
–
Why · Quick Start · Compare · Tiers · Benchmarks · API · Docs · FAQ · Discord
Why TrueMemory
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.
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.
Join the Discord to see what others are building with TrueMemory.
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.
New to the terminal? Click here for step-by-step instructions.
- Open a terminal: Mac:
Cmd + Space, typeTerminal. 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). - Type "Set up TrueMemory" and pick a tier.
Windows (PowerShell):
irm https://raw.githubusercontent.com/buildingjoshbetter/TrueMemory/main/install.ps1 | iex
That's it. TrueMemory remembers your conversations automatically from here. Need help? Join our Discord.
If TrueMemory saves you time, a ⭐ helps other devs find it.
For developers (Python library)
pip install truememory
from truememory import Memory
Similar plugs
Reverse engineer anything with agents, from app behavior down to native binaries.
Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype…
User-friendly AI Interface (Supports Ollama, OpenAI API, ...)
A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io