memory

/memory Command

Manage cross-device semantic memory for scaffolding (self-hosted mem0 + pgvector, Ollama on GPU). Opt-in, per-device. Memory is off by default — nothing is wired until you enable it.

Usage

/memory enable     # wire the memory MCP backend into Claude Code (user scope)
/memory disable    # remove it from this device (stored memories on the backend are kept)
/memory status     # show whether it's wired and reachable

The assistant reads the argument (enable / disable / status; default: status) and performs the matching section below.

---

enable

Connects this device so scaffolding agents gain persistent memory via the semantic_search / semantic_recall / semantic_store tools (see the semantic-memory-mcp and semantic-memory-store skills). The token is personal — memory is yours only; anyone without it gets 401.

1. Check the token is in the environment:

   test -n "${MEMORY_MCP_TOKEN:-}" || echo "MEMORY_MCP_TOKEN not set — export it (e.g. from Vault: export MEMORY_MCP_TOKEN=$(vault kv get -field=token kv/memory/mcp)) and re-run"
   

2. Register the MCP server (user scope; default endpoint = homelab backend, override with MEMORY_MCP_URL):

   claude mcp add --scope user --transport http memory \
     "${MEMORY_MCP_URL:-http://memory.bernardynska.waw.pl:8000/mcp}" \
     --header "Authorization: Bearer \${MEMORY_MCP_TOKEN}"
   

   (The literal ${MEMORY_MCP_TOKEN} is stored and expanded at runtime — the token is never written to disk.)
3. Verify: claude mcp list | grep memory
4. (Optional) Wire token auto-refresh from Vault. Offer this only if the user wants the token kept fresh per-device without manual re-export. It installs a SessionStart hook (shipped with the plugin) into user settings — opt-in, never an always-on plugin hook:

   mkdir -p "$HOME/.claude/hooks"
   cp "${CLAUDE_PLUGIN_ROOT}/hooks/refresh-mcp-token.sh" "$HOME/.claude/hooks/refresh-mcp-token.sh"
   chmod 700 "$HOME/.claude/hooks/refresh-mcp-token.sh"
   python3 - "$HOME/.claude/settings.json" <<'PY'
   import json, os, sys
   p = sys.argv[1]
   d = json.load(open(p)) if os.path.exists(p) else {}
   cmd = "$HOME/.claude/hooks/refresh-mcp-token.sh"
   ss = d.setdefault("hooks", {}).setdefault("SessionStart", [])
   if not any(h.get("command") == cmd for e in ss for h in e.get("hooks", [])):
       ss.append({"matcher": "", "hooks": [{"type": "command", "command": cmd, "timeout": 30}]})
       json.dump(d, open(p, "w"), indent=2); open(p, "a").write("\n")
       print("auto-refresh hook installed")
   else:
       print("auto-refresh hook already present")
   PY
   

   It re-pulls MEMORY_MCP_TOKEN from Vault (kv/memory/mcp) each session and keeps settings.json topped up. Requires the vault CLI + a valid login; a clean no-op without them. Skip if the token is supplied another way (e.g. the claude() shell wrapper). Takes effect next session.
5. Tell the user to restart Claude Code so the server + token load and connect. After restart, mcp__memory__* tools are available and skills use them automatically.