delx-memory

library0.2.2jsnpmunverified

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.

ai-ml

npm install delx-memory

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · DELX-MEMORY

delx-memory

ai-mljavascriptv0.2.2

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

delx-memory

✓ npx -y delx-memory

✗ npm install delx-memory --save

Package is an MCP server binary, not a library. Run via npx or install globally. Do not import as a module.

MCP client configuration

✓ Add to mcpServers in Claude Desktop config: {"command":"npx","args":["-y","delx-memory"]}

✗ Adding as a regular npm dependency or importing in code

Configuration is per MCP client JSON file, not code-level integration.

doctor command

✓ npx -y delx-memory doctor

✗ delx-memory --doctor or delx doctor

The doctor subcommand is required for initial setup and diagnostics.

Shows installation, configuration, and basic tool usage for an MCP client via Claude Desktop.

// Step 1: Check system compatibility npx -y delx-memory doctor // Step 2: Add to Claude Desktop config // ~/Library/Application Support/Claude/claude_desktop_config.json { "mcpServers": { "delx-memory": { "command": "npx", "args": ["-y", "delx-memory"] } } } // Step 3: Restart Claude Desktop and use tools // Example: // - memory_stats (get store overview) // - memory_set { key: "project-idea", value: "AI writing assistant", tags: ["writing", "ideas"], explicit_user_intent: true } // - memory_get { key: "project-idea" } // - memory_search { query: "writing assistant" }

Debug

Known issues

gotchaMutations require explicit_user_intent: true to prevent silent writes.

fix

Always pass explicit_user_intent: true in tool call parameters for set, forget, forget_by_tag, and export.

affects: >=0.0.0

breakingNode.js version 20+ required. Older versions will fail to run.

fix

Install Node.js 20 via nvm or official installer: nvm install 20

affects: >=0.1.0

gotchaSecret-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.

fix

Use a dedicated secrets manager (Keychain, gnome-keyring, Windows Credential Manager) for such data.

affects: >=0.1.0

deprecatedNo deprecated features identified yet (alpha software).

fix

N/A

affects: >0.0.0

Errors

Common errors & fixes

Error: Cannot find module 'delx-memory'

Delx-memory is a binary tool, not a node module. Running without npx or global install.

fix

Use npx -y delx-memory doctor instead of require/import.

Error: SQLITE_ERROR: no such table: memory

Database file missing or corrupt. Expected at ~/.delx-memory/db.sqlite.

fix

Run 'npx -y delx-memory doctor' to verify and initialize the database.

Error: Function not implemented (os_get_tmpdir?)

Node.js version below 20. Delx-memory uses modern Node APIs.

fix

Upgrade to Node.js >=20 using nvm install 20.

Error: Credential-shaped value rejected

Value contains patterns like 'eyJ' (JWT) or 'Bearer' which are blocked by security filter.

fix

Store credentials in a dedicated secrets manager, not in delx-memory.

Upgrade

Version history

0.2.2latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

14 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/davidmosiah/delx-memory ↗

packagedelx-memory ↗

homepagehttps://github.com/davidmosiah/delx-memory ↗