total-agent-memory
v1.1.0
Published
Persistent memory for Claude Code, Codex CLI, Cursor and any MCP client. Local-first, hits #5 on LoCoMo. One command to install.
Maintainers
Readme
total-agent-memory
Persistent memory for Claude Code, Codex CLI, Cursor, Cline and any MCP client. Local-first. Hits #5 on LoCoMo and 96.2% R@5 on LongMemEval.
npx -y total-agent-memoryThat's it. One command bootstraps a Python virtual env in ~/.tam/ (legacy
~/.claude-memory/ is migrated automatically with a symlink kept for
backward-compat), installs the MCP server, and prints next-step instructions
for wiring your IDE.
Quick start
# Onboard (install + show next steps)
npx -y total-agent-memory
# Or explicit
npx -y total-agent-memory install
npx -y total-agent-memory connect claude-code
npx -y total-agent-memory connect cursor
npx -y total-agent-memory connect codex
npx -y total-agent-memory statusAlias: tam (same binary).
Commands
| Command | What it does |
|---|---|
| install | Create venv, install Python server. Idempotent. |
| start | Run the MCP server (stdin/stdout). |
| connect <ide> | Wire an IDE config. claude-code codex cursor cline continue windsurf gemini-cli opencode aider |
| demo | Health-check end-to-end. |
| status | Print install paths, DB size. |
| doctor | Diagnose Python/uv/git on PATH. |
| upgrade | Pull the latest server version. |
| uninstall | Remove ~/.tam (needs --yes). Also removes ~/.claude-memory if it's a symlink to ~/.tam. |
Options
| Flag | Meaning |
|---|---|
| --server-version 11.2.2 | Pin a specific server release. |
| --source pypi\|git | Force install source. Default: PyPI with GitHub fallback. |
| --memory-dir /path | Override install dir (default ~/.tam). |
| --yes | Skip prompts (needed for uninstall). |
| --no-color | Disable ANSI. |
| --verbose | Print every shell command. |
Requirements
- Node ≥ 18 (you already have it if you're reading this).
- Python ≥ 3.10 on PATH. The wrapper will tell you how to install it if missing.
- Optional: uv — 10× faster installs, auto-detected.
What gets installed
~/.tam/
├── .venv/ # isolated Python env
│ └── bin/total-agent-memory # MCP server entry-point (legacy claude-total-memory also installed)
└── memory.db # SQLite — your memory lives hereNothing global is touched. Uninstall with tam uninstall --yes.
Links
- Site: https://totalmemory.dev
- Server source: https://github.com/vbcherepanov/total-agent-memory
- PyPI package:
total-agent-memory(legacyclaude-total-memoryis now a deprecation shim)
License
MIT
