Verify it works

If install ran cleanly you’re already done. Use this page if anything feels off.

1. Storage is live

ls -la ~/.plur/

You should see at minimum engrams.yaml (or a sharded store), episodes.jsonl, index/, and config.yaml. If ~/.plur/ is empty or missing, re-run npx @plur-ai/mcp init (or your adapter’s init equivalent).

2. The MCP server starts

npx @plur-ai/cli status

Expected output:

✓ Storage:   /Users/you/.plur/  (engrams: 0, episodes: 0)
✓ Embedder:  bge-m3 (local, healthy)
✓ Index:     ready
✓ Hooks:     Claude Code hooks installed

If the embedder is unhealthy:

npx @plur-ai/cli doctor

doctor checks embedder availability, hook installation, MCP config, and disk permissions; it tells you the exact fix for each red line.

3. Your agent sees the tools

Ask whichever AI tool you installed PLUR into:

“Run plur_status and tell me the engram count.”

If it answers with a count and store path, the MCP server is reachable. If the agent says it has no plur_status tool, the MCP config didn’t load — restart the agent, then re-check ~/.mcp.json or the equivalent for your tool.

4. Hooks fire (Claude Code / OpenClaw)

Open a fresh Claude Code session in any project. The first message of the session should silently inject up to a few engrams. To confirm:

tail -f ~/.plur/episodes.jsonl

…then send “hello” to your agent. You should see an injected_engrams event with a session_id. If nothing appears, the hooks aren’t wired — re-run plur init (CLI) or npx @plur-ai/mcp init (MCP) and restart the editor.

5. Save → recall round trip

plur learn "Smoke test memory" --domain smoke-test
plur recall "smoke test"
plur forget ENG-XXXX-XXXX-XXX   # ID printed by step 1

If learn returns an ID, recall finds it, and forget removes it without error, PLUR is healthy end-to-end.

Common issues

bge-m3 model not downloading. First-run embedder download is ~500 MB. On a slow link, give it five minutes. Re-run plur doctor after.

Hooks not firing in Claude Code. Make sure .claude/settings.json (project) or ~/.claude/settings.json (global) has the PLUR SessionStart and UserPromptSubmit hooks. plur init writes these; if you edit by hand, see Hooks reference.

Wrong CLI version. Verified pairing is @plur-ai/cli@0.9.4 and plur-hermes==0.9.4. Mixed versions occasionally drift in tool names.

Permission denied on ~/.plur/. Either you installed as root and now run as user, or filesystem permissions are odd. chmod -R u+rw ~/.plur/ fixes it.

Still stuck? Open an issue at github.com/plur-ai/plur with the full plur doctor output.