total-agent-memory
by vbcherepanov·★ 34·Score 46
Persistent memory layer for AI coding agents with knowledge graphs, embeddings, and 3D visualization.
Overview
total-agent-memory is a sophisticated memory system for AI coding assistants like Claude Code, Codex CLI, and Cursor. It maintains a persistent, local knowledge base that learns how developers work, not just what they said. The system uses temporal knowledge graphs, procedural memory, and AST-based codebase ingestion to provide context across sessions and projects. It features hybrid retrieval combining BM25, dense vectors, graph relations, and other techniques to achieve 96.2% R@5 on LongMemEval benchmarks.
Try asking AI
After installing, here are 3 things you can ask your AI assistant:
When to choose this
Choose total-agent-memory when you need persistent memory for AI coding agents with strong local privacy guarantees and want to preserve context across sessions without cloud dependencies.
When NOT to choose this
Don't choose this if you need cloud-based memory synchronization across multiple machines or require a fully managed SaaS solution without any self-hosting requirements.
Tools this server exposes
12 tools extracted from the READMEmemory_save_fastSave memory content quickly without LLM calls in fast mode
memory_search_fastSearch memory quickly with hybrid retrieval in fast mode
memory_explain_searchExplain how a search query was processed
memory_warmupWarm up the memory system for faster initial access
memory_perf_reportGet performance metrics for the memory system
memory_rebuild_ftsRebuild the full-text search index
memory_rebuild_embeddingsRebuild all embedding indexes with current models
memory_eval_locomoRun LoCoMo benchmark on memory system
memory_eval_recallEvaluate memory recall performance
memory_eval_temporalEvaluate temporal reasoning capabilities of memory
memory_eval_entity_consistencyEvaluate consistency in entity extraction across sessions
memory_eval_contradictionsCheck for contradictions in memory knowledge
Comparable tools
Installation
Installation
Prerequisites
- Python 3.8+
- SQLite (included)
- Optional: Ollama for advanced features
Basic Install
pip install total-agent-memoryClaude Desktop Integration
Add to Claude Desktop config.json:
{
"mcpServers": {
"total-agent-memory": {
"command": "python",
"args": ["-m", "total_agent_memory.server"],
"env": {}
}
}
}Quick Start
total-agent-memory init
total-agent-memory serveCompare total-agent-memory with
Last updated · Auto-generated from public README + GitHub signals.