run_compactLABSCO SUMMARY
Your memory stops fragmenting across vendors.
Every tool solves this in its own silo — a rules file here, a memory feature there — but you are the constant. One SQLite file that any MCP client can read means the decisions you made last week survive changing which assistant you use this year.
What it is
A memory layer that runs over a local SQLite file and speaks MCP, so Claude Desktop, Claude Code, Cursor, Copilot, Cline, OpenCode, Aider or a custom agent all read and write the same durable, structured memories about you and your work. Local-first, with no outbound network calls by default.
What you get
- 38 tools, named
verb_noun— every registry command whose surfaces include MCP - Reading —
search_memory,read_memory,list_memories,get_memory_context,list_memory_events - Writing —
write_memory,write_many_memories,update_memory,supersede_memory,extract_memory - Curating —
confirm_memoryandconfirm_many_memoriesto keep a memory alive,archive_memory,forget_memory,restore_memory, and the bulk forms, which requireconfirm: trueand preview by default - Housekeeping —
run_compactarchives cold memories whose confidence has decayed past the threshold,rebuild_embeddings,set_memory_embedding - Conflicts —
scan_conflicts,list_conflicts,read_conflict,resolve_conflict,list_conflict_events - Packs —
install_pack,preview_pack,list_packs,export_pack,uninstall_pack, so a curated set of memories can be shared as a file or a URL - Configuration and system —
get_config,set_config,unset_config,list_config,list_config_history,info_system,list_scopes_system,list_tags_system
Requirements
Node.js 22.11+. Run npx @psraghuveer/memento init, which creates the database under $XDG_DATA_HOME/memento/memento.db, runs migrations, and on a terminal asks four setup questions — your preferred name, whether to install the bundled skill, whether to seed a starter pack, and whether to write the persona snippet into the custom-instructions file of each AI client it detects. It then prints the MCP snippet for every supported client; restart the client after pasting it. The persona snippet matters: of the three teaching surfaces, it is the only one guaranteed to reach the assistant's system prompt on every message, so UI-only clients need it pasted by hand. Verify the whole path with npx @psraghuveer/memento verify-setup, which does a write, search and cleanup round-trip.
Setup effort
One command — npx @psraghuveer/memento init
USE CASES
Not re-explaining your preferences every session
Tell one assistant once; the memory is written to the shared store and every other client reads it at the start of the next session.
Recalling why a decision was made
Search the store for the topic and read the memory back with its context, rather than digging through old transcripts.
Starting from something rather than nothing
Install one of the bundled packs so a fresh store already holds useful engineering memories on day one.
Keeping the store from rotting
Confirm the memories that still hold and let compaction archive the cold ones whose confidence has decayed past the threshold.
Handling two memories that contradict each other
Run conflict detection, read the conflict, and resolve it — or supersede the older memory outright.
Sharing a team's conventions
Author a pack from your own memories and distribute it as a file or an HTTPS URL for teammates to install.
38 tools
Listed in project docs. Your client may show a different list.
get_configlist_config_historylist_configset_configunset_configlist_conflict_eventslist_conflictsread_conflictresolve_conflictscan_conflictsrebuild_embeddingsarchive_memoryarchive_many_memoriesconfirm_memoryconfirm_many_memoriesget_memory_contextlist_memory_eventsextract_memoryforget_memoryforget_many_memorieslist_memoriesread_memoryrestore_memorysearch_memoryset_memory_embeddingsupersede_memoryupdate_memorywrite_memorywrite_many_memoriesexport_packinstall_packlist_packspreview_packuninstall_packinfo_systemlist_scopes_systemlist_tags_systemBEFORE YOU INSTALL
What to know first
Tools you get
38 tools named in the project's documentation.
Requires
npx on PATH
INSTALLATION
Connect your client
Server setup
GitHub Copilot, Aider, VS Code
npx @psraghuveer/memento init