reasonix-plugmem

PlugMem MCP Server — standalone memory graph with semantic, procedural, and episodic memory types across Reasonix sessions.

Pure Node.js, zero external dependencies, no proxy required. Provides 9 MCP tools for persistent, searchable long-term memory.

Quick Install (npx — no installation required)

Add to ~/.reasonix/config.json:

{
  "mcp": [
    "plugmem=npx -p reasonix-plugmem plugmem-mcp"
  ]
}

Then restart Reasonix. Done.

Prerequisites

• Reasonix — the AI coding assistant platform that supports MCP servers
• Node.js >= 18

Quick Start

Step 1: Install Reasonix (if not already installed)

npm install -g reasonix

Step 2: Navigate to your project

cd your-project-directory

This is important — PlugMem stores data in .reasonix/plugmem_data/ relative to the current working directory, so each project has isolated memories.

Step 3: Add PlugMem to Reasonix's MCP config

Edit ~/.reasonix/config.json:

{
  "mcp": [
    "plugmem=npx -p reasonix-plugmem plugmem-mcp"
  ],
  "apiKey": "sk-..."
}

What this does:

• npx — downloads and runs the package from npm without permanent installation
• -p reasonix-plugmem — specifies the npm package name to download
• plugmem-mcp — the binary/command to run inside that package
• plugmem= — the MCP server name prefix that Reasonix uses for its tools

Alternative: install globally and use a shorter command:

npm install -g reasonix-plugmem

Then in ~/.reasonix/config.json:

"plugmem=plugmem-mcp"

Step 4: Restart Reasonix

Close and reopen Reasonix. The startup log should show:

✓ MCP · plugmem ✓ connected    10 tools · 0 resources · ~70ms

Available Tools

| Tool | Description | |------|-------------| | plugmem_get_stats | Display graph statistics | | plugmem_list_graphs | List all memory graphs | | plugmem_retrieve | Semantic memory retrieval | | plugmem_insert_semantic | Store facts / concepts / preferences | | plugmem_insert_procedural | Store workflows / procedures | | plugmem_insert_episodic | Store interaction trajectories | | plugmem_reason | Retrieve + LLM reasoning over memories | | plugmem_browse_nodes | Paginated node browsing | | plugmem_create_graph | Create a new graph | | plugmem_delete_graph | Delete a graph |

Each Project Has Its Own Memory

PlugMem discovers its data directory based on where you run Reasonix:

project-a/
  └── .reasonix/plugmem_data/graph_default.json

project-b/
  └── .reasonix/plugmem_data/graph_default.json

No interference between projects.

Data Storage

By default, memories are stored as JSON files in .reasonix/plugmem_data/. Override with the PLUGMEM_DIR environment variable.

Memory Types

• Semantic — factual knowledge, user preferences, decisions (tagged, vector-searchable)
• Procedural — step-by-step workflows, how-to knowledge (keyed by subgoal)
• Episodic — session interaction trajectories (observation/action sequences)

Requirements

• Node.js >= 18
• Reasonix (any version with MCP support)

License

MIT