memory_storeLABSCO SUMMARY
Local retrieval that publishes its numbers, and a compact mode that matters.
Two things stand out. The retrieval is a real pipeline rather than a keyword search — a bi-encoder plus an int8 cross-encoder reranker, both local, with the reranker taking about three quarters of the roughly 14ms median latency. And recall defaults to compact mode, returning enough to choose from and leaving the full content behind memory_detail, which is the difference between a memory tool that saves context and one that eats it. Benchmark figures come from the amem-core engine on LongMemEval-S.
What it is
An MCP server that gives every AI coding tool the same persistent memory, backed by one SQLite file at ~/.amem/memory.db. The retrieval engine lives in a separate library, amem-core, so recall improvements and MCP tool changes ship independently. Everything runs locally: no cloud, no API keys, no vector database.
What you get
- Core memory work —
memory_storewith a type, tags and confidence (auto-redacting private content and auto-expiring contradictions),memory_recallfor semantic search in a compact mode,memory_detailfor the full content of one result,memory_contextto load everything relevant to a topic under a token budget,memory_extractfor batch saves,memory_forget, andmemory_injectto surface corrections, decisions and graph neighbours before coding starts - Precision and history:
memory_patchfor a field-level edit with an automatic snapshot,memory_versionsto view or restore any earlier version,memory_searchfor exact full-text search via FTS5,memory_sincefor temporal queries in natural ranges like7dor2w, andmemory_relateto build a typed knowledge graph - Advanced retrieval and lifecycle —
memory_multi_recallfusing semantic, full-text, graph and temporal search;memory_tierto move memories between core, working and archival;memory_expire;memory_summarizeandmemory_historyfor session summaries memory_reflect, a reflection engine that clusters your memories, detects contradictions, identifies synthesis candidates and surfaces knowledge gaps, returning a report with suggested actions and a health score- Six memory types ranked by priority, with corrections at the top so an agent's hard constraints always surface first: correction, decision, pattern, preference, topology, fact
- Three memory tiers — Core, always injected at session start; Working, session-scoped; Archival, searchable but not auto-injected — and temporal validity, where superseded facts are expired rather than deleted so you can still ask what was true in March
- Admin, reminders and maintenance:
memory_doctorandmemory_repairfor the database,memory_config,memory_syncto import and export against Claude auto-memory and Copilot instructions, four reminder tools, andmemory_log,memory_stats,memory_export,memory_importandmemory_consolidate
Requirements
No account, no API key, no cloud. Node 18 or newer. In Claude Code and GitHub Copilot CLI it installs as a plugin from the repository's marketplace; for Cursor, Windsurf or any other MCP client, npm install -g @aman_asmuei/amem then amem-cli init detects and configures the tools you have installed, and amem-cli rules writes extraction rules so the assistant reaches for memory on its own. amem-cli stats confirms it is live. The npm package is @aman_asmuei/amem, run over stdio.
Setup effort
One command — npm install -g @aman_asmuei/amem
USE CASES
Telling a rule to one tool and having every tool know it
Store a correction once; the same SQLite store is read by whichever assistant you open next.
Loading the right context before you start coding
Surface the corrections, decisions and their graph neighbours for the area you are about to touch, under a token budget.
Finding what changed and when
Query a natural time range, then read a specific memory's edit history and restore an earlier version if the current one is wrong.
Cleaning up a memory store that has grown messy
Run reflection to see the clusters, contradictions and knowledge gaps, then consolidate duplicates and prune the stale ones.
Not losing a fact when it stops being true
Expire it instead of deleting it — it drops out of recall but the history stays queryable.
33 tools
Listed in project docs. Your client may show a different list.
memory_recallmemory_detailmemory_contextmemory_extractmemory_forgetmemory_injectmemory_patchmemory_versionsmemory_searchmemory_sincememory_relatememory_multi_recallmemory_tiermemory_expirememory_summarizememory_historymemory_reflectmemory_doctormemory_repairmemory_configmemory_syncreminder_setreminder_listreminder_checkreminder_completememory_logmemory_log_recallmemory_log_cleanupmemory_statsmemory_exportmemory_importmemory_consolidateBEFORE YOU INSTALL
What to know first
Tools you get
33 tools named in the project's documentation.
Requires
npx on PATH
INSTALLATION
Connect your client
Server setup
npm install -g @aman_asmuei/amemMCP Clients
Claude Code
/plugin marketplace add amanasmuei/amem
/plugin install amemGitHub Copilot
copilot plugin marketplace add amanasmuei/amem
copilot plugin install amemCursor, Windsurf, Any MCP client
{
"mcpServers": {
"amem": {
"command": "npx",
"args": [
"-y",
"@aman_asmuei/amem"
]
}
}
}