Install (30 seconds)

PLUR installs globally — one MCP server, one engram store at ~/.plur/, available in every project. You only run init once per machine.

npx @plur-ai/mcp init

This single command:

creates ~/.plur/ for engram storage,
adds PLUR to your ~/.mcp.json MCP server list,
installs Claude Code hooks for automatic engram injection on session start and learning capture on corrections.

Restart Claude Code. You’re done.

Add to .cursor/mcp.json (or the user-level equivalent):

{
  "mcpServers": {
    "plur": { "command": "npx", "args": ["-y", "@plur-ai/mcp"] }
  }
}

Restart Cursor. Memory is now available as MCP tools. To enable automatic injection, see Multi-project setup.

Add to your Windsurf MCP config:

{
  "mcpServers": {
    "plur": { "command": "npx", "args": ["-y", "@plur-ai/mcp"] }
  }
}

openclaw plugins install @plur-ai/claw
openclaw gateway --force

OpenClaw is the deepest integration — PLUR runs as a ContextEngine plugin with seven lifecycle hooks. Memory injection on session start, learning extraction from corrections, and episode capture after each turn — all automatic. No config files.

pip install plur-hermes
npm install -g @plur-ai/cli@0.9.4

The plugin auto-registers via Hermes’ plugin system. It injects relevant memories before each LLM call, extracts learnings from agent responses, and exposes 16 PLUR tools to the agent. Hermes shells out to the PLUR CLI under the hood — current verified pairing is plur-hermes==0.9.4 with @plur-ai/cli@0.9.4.

npm install -g @plur-ai/cli@0.9.4
plur init

plur init writes Claude Code hooks and the local hook binary. The CLI is also the universal bridge — any agent that can shell out can call plur learn, plur recall, plur inject.

Global install (faster startup)

The npx approach above resolves on every invocation. For lower latency:

npm install -g @plur-ai/mcp
plur-mcp init

The init step works the same way; you save ~300 ms per MCP session start.

Verify

npx @plur-ai/cli status

You should see your engram count, store path (~/.plur/), and embedder health. If you’d rather ask your agent: “What’s my PLUR status?” — it should call plur_status and return the same info. Full verification walkthrough →

Next: Your first memory →