memoryrouter-claude

Persistent memory for Claude Code. One command installs hooks that give Claude Code a real long-term memory: relevant context injected into every turn, every conversation captured, and nothing lost to compaction — powered by MemoryRouter.

npx memoryrouter-claude init

That's it. Paste your Memory Key (free at app.memoryrouter.ai), pick a scope, and your Claude Code sessions remember everything — across sessions, across machines, across every AI platform connected to your vault.

Why

Claude Code's built-in auto memory is local notes per project on one machine. MemoryRouter is a different layer:

• Semantic search over your full conversation history, not curated notes
• Cross-machine — same memory on your laptop and your server
• Cross-platform — the same vault works in ChatGPT, Claude.ai, OpenClaw, and your own apps
• Compaction-proof — the full transcript is saved before Claude Code compacts it away

How it works

The installer adds five hooks to your Claude Code settings:

┌────────────────────────────────────────────────────────────────┐
│                       Claude Code session                      │
│                                                                │
│  SessionStart ──────► POST /v1/memory/warmup                   │
│                       (pre-load your vault → fast first recall)│
│                                                                │
│  UserPromptSubmit ──► POST /v1/memory/prepare                  │
│   (every prompt)      relevant memories injected as context    │
│                                                                │
│  Stop ──────────────► POST /v1/memory/ingest                   │
│   (every turn)        user prompt + assistant reply captured   │
│                                                                │
│  PreCompact ────────► POST /v1/memory/ingest                   │
│   (before compaction) full un-saved transcript flushed         │
│                                                                │
│  SessionEnd ────────► POST /v1/memory/ingest                   │
│   (session close)     final flush                              │
└────────────────────────────────────────────────────────────────┘
                  api.memoryrouter.ai  ·  Bearer mk_xxx

Every hook fails open: if the network or API is down, the hook exits 0 instantly and Claude Code continues as if nothing happened. Your prompts are never blocked, ever.

Commands

| Command | What it does | |---|---| | npx memoryrouter-claude init | Validate key, install hooks (interactive) | | npx memoryrouter-claude init --key mk_xxx --user --yes | Non-interactive install for all projects | | npx memoryrouter-claude status | Key validity + vault stats | | npx memoryrouter-claude off | Remove our hooks (only ours — your other hooks untouched) | | npx memoryrouter-claude hook <kind> | Internal — invoked by Claude Code |

Scopes

• --project (default): writes to ./.claude/settings.json — this project only, committable
• --user: writes to ~/.claude/settings.json — every project on this machine

The installer merges with your existing settings. It never overwrites other hooks or settings, it's idempotent (run it twice, get one set of hooks), and off removes exactly what it added.

Configuration

| What | Where | |---|---| | Memory Key | ~/.memoryrouter/config.json (created with 0600 permissions) | | Per-session state | ~/.memoryrouter/state/<session_id>.json | | Env override | MEMORYROUTER_API_KEY (takes priority over the config file) | | Debug logging | MEMORYROUTER_DEBUG=1 (hooks log to stderr) | | API base override | MEMORYROUTER_API_BASE (testing) |

Optional knobs in ~/.memoryrouter/config.json:

{
  "apiKey": "mk_...",
  "contextLimit": 2000,
  "density": "balanced"
}

Security notes

• Your Memory Key is stored only in ~/.memoryrouter/config.json with 0600 permissions — never inside .claude/settings.json, so committing project settings never leaks your key.
• All API traffic is HTTPS to api.memoryrouter.ai with Authorization: Bearer auth.
• Want read-only injection with no capture? Use a key with the :read suffix (mk_xxx:read) — the server skips storage automatically.
• Nothing is ever sent anywhere except your MemoryRouter vault.

Uninstall

npx memoryrouter-claude off        # removes hooks from project + user settings
rm -rf ~/.memoryrouter      # removes your key + local state

Requirements

• Node.js ≥ 18
• Claude Code
• A MemoryRouter Memory Key — free at app.memoryrouter.ai

License

MIT © MemoryRouter