{"id":44711,"library":"delx-memory","title":"delx-memory","description":"Local-first persistent memory MCP server that provides a shared SQLite-backed key/value store for multiple MCP-speaking AI agents (Claude Desktop, Cursor, Hermes, OpenClaw, Codex). Version 0.2.2 (alpha), open source (MIT), Node.js >=20 required. Unlike ephemeral per-client memory solutions, delx-memory enables cross-session and cross-tool context persistence via a single SQLite file at ~/.delx-memory/db.sqlite. Features 8 MCP tools (4 read-only, 4 mutation requiring explicit user intent), TTL support, tags, prefix filters, FTS5 full-text search, secret-blocking for credential-shaped keys/values, and zero telemetry. The server is designed as a lightweight MCP tool, not a generalized database.","status":"active","version":"0.2.2","language":"javascript","source_language":"en","source_url":"https://github.com/davidmosiah/delx-memory","tags":["javascript","mcp","model-context-protocol","memory","persistent-memory","agent-memory","local-first","sqlite","ai-agents","typescript"],"install":[{"cmd":"npm install delx-memory","lang":"bash","label":"npm"},{"cmd":"yarn add delx-memory","lang":"bash","label":"yarn"},{"cmd":"pnpm add delx-memory","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"Package is an MCP server binary, not a library. Run via npx or install globally. Do not import as a module.","wrong":"npm install delx-memory --save","symbol":"delx-memory","correct":"npx -y delx-memory"},{"note":"Configuration is per MCP client JSON file, not code-level integration.","wrong":"Adding as a regular npm dependency or importing in code","symbol":"MCP client configuration","correct":"Add to mcpServers in Claude Desktop config: {\"command\":\"npx\",\"args\":[\"-y\",\"delx-memory\"]}"},{"note":"The doctor subcommand is required for initial setup and diagnostics.","wrong":"delx-memory --doctor or delx doctor","symbol":"doctor command","correct":"npx -y delx-memory doctor"}],"quickstart":{"code":"// Step 1: Check system compatibility\nnpx -y delx-memory doctor\n\n// Step 2: Add to Claude Desktop config\n// ~/Library/Application Support/Claude/claude_desktop_config.json\n{\n  \"mcpServers\": {\n    \"delx-memory\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"delx-memory\"]\n    }\n  }\n}\n\n// Step 3: Restart Claude Desktop and use tools\n// Example: \n// - memory_stats (get store overview)\n// - memory_set { key: \"project-idea\", value: \"AI writing assistant\", tags: [\"writing\", \"ideas\"], explicit_user_intent: true }\n// - memory_get { key: \"project-idea\" }\n// - memory_search { query: \"writing assistant\" }","lang":"typescript","description":"Shows installation, configuration, and basic tool usage for an MCP client via Claude Desktop."},"warnings":[{"fix":"Always pass explicit_user_intent: true in tool call parameters for set, forget, forget_by_tag, and export.","message":"Mutations require explicit_user_intent: true to prevent silent writes.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Install Node.js 20 via nvm or official installer: nvm install 20","message":"Node.js version 20+ required. Older versions will fail to run.","severity":"breaking","affected_versions":">=0.1.0"},{"fix":"Use a dedicated secrets manager (Keychain, gnome-keyring, Windows Credential Manager) for such data.","message":"Secret-blocking feature refuses to store keys matching patterns like token, secret, password, api_key, bearer, etc. Values shaped like JWTs (eyJ…) or Bearer tokens are also rejected.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"N/A","message":"No deprecated features identified yet (alpha software).","severity":"deprecated","affected_versions":">0.0.0"}],"env_vars":null,"search_vec":"'/.delx-memory/db.sqlite':68 '0.2.2':34 '20':40 '4':73,77 '8':70 'agent':26,128,136 'agent-memori':127 'ai':25,135 'ai-ag':134 'alpha':35 'back':17 'block':95 'claud':27 'client':46 'codex':32 'context':60,121 'credenti':98 'credential-shap':97 'cross':54,58 'cross-sess':53 'cross-tool':57 'cursor':29 'databas':116 'delx':2,50 'delx-memori':1,49 'design':107 'desktop':28 'enabl':52 'ephemer':43 'explicit':80 'featur':69 'file':66 'filter':87 'first':6,132 'fts5':88 'full':90 'full-text':89 'general':115 'herm':30 'intent':82 'javascript':117 'key/value':18 'keys/values':100 'lightweight':110 'local':5,131 'local-first':4,130 'mcp':9,23,71,111,118 'mcp-speak':22 'memori':3,8,47,51,123,126,129 'mit':38 'model':120 'model-context-protocol':119 'multipl':21 'mutat':78 'node.js':39 'open':36 'openclaw':31 'per':45 'per-client':44 'persist':7,61,125 'persistent-memori':124 'prefix':86 'protocol':122 'provid':12 'read':75 'read-on':74 'requir':41,79 'search':92 'secret':94 'secret-block':93 'server':10,105 'session':55 'shape':99 'share':14 'singl':64 'solut':48 'sourc':37 'speak':24 'sqlite':16,65,133 'sqlite-back':15 'store':19 'support':84 'tag':85 'telemetri':103 'text':91 'tool':59,72,112 'ttl':83 'typescript':137 'unlik':42 'user':81 'version':33 'via':62 'zero':102","created_at":"2026-06-07T12:51:27.728213+00:00","updated_at":"2026-06-07T12:51:27.728213+00:00","problems":[{"fix":"Use npx -y delx-memory doctor instead of require/import.","cause":"Delx-memory is a binary tool, not a node module. Running without npx or global install.","error":"Error: Cannot find module 'delx-memory'"},{"fix":"Run 'npx -y delx-memory doctor' to verify and initialize the database.","cause":"Database file missing or corrupt. Expected at ~/.delx-memory/db.sqlite.","error":"Error: SQLITE_ERROR: no such table: memory"},{"fix":"Upgrade to Node.js >=20 using nvm install 20.","cause":"Node.js version below 20. Delx-memory uses modern Node APIs.","error":"Error: Function not implemented (os_get_tmpdir?)"},{"fix":"Store credentials in a dedicated secrets manager, not in delx-memory.","cause":"Value contains patterns like 'eyJ' (JWT) or 'Bearer' which are blocked by security filter.","error":"Error: Credential-shaped value rejected"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/davidmosiah/delx-memory","github":"https://github.com/davidmosiah/delx-memory","docs":null,"changelog":null,"pypi":null,"npm":"delx-memory","openapi_spec":null,"status_page":null,"smithery":null,"categories":["ai-ml"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-07","next_check":"2026-09-05","install_tag":null}}