Skip to main content

​
Cursor Integration

Give Cursor a memory that lasts across chats. The installer wires Cursor hooks (small scripts Cursor runs when a session starts, a file is read, or a tool runs), starts the local worker (the program that stores notes), and uses CMEM Pro (the hosted memory service) unless you pick another provider.

One command

npx claude-mem install — do not clone the repo to install.

CMEM Pro default

Memory notes are written off-plan through the hosted service unless you pick Gemini, OpenRouter, or your Anthropic plan.

Cursor hooks

Cursor has hooks. Grok Bot does not — that host is a different guide.

Memory viewer

Open the worker URL printed at install to browse saved notes.

​
Install

When the installer lists your apps, pick Cursor. The three stages are: install runtime, sign in (device code, no email in the CLI), then pick a memory provider. CMEM Pro is pre-selected. Other provider choices: your Gemini key, your OpenRouter key, or your Anthropic plan (--provider claude, which skips cmem.ai). Details: Installation.
npm install -g claude-mem installs the library only. It does not register Cursor hooks or start the worker. Always use npx claude-mem install.
Do not clone this repository to install. Clone is for people changing the code.

​
How it works

  1. Hooks record what the agent does in Cursor.
  2. Worker stores those notes on your machine (default 127.0.0.1, port in ~/.claude-mem/.worker.port).
  3. Next chat gets relevant past notes.
  4. Viewer at the worker URL shows the knowledge base.
Never restart a healthy worker. The note queue sits in memory; a restart drops it.

​
Gemini or OpenRouter instead of CMEM Pro

  • Gemini — your Google key, memory off-plan
  • OpenRouter — your OpenRouter key. Never send a personal sk-or- key to https://cmem.ai/api/inference

​
Verify it worked

  1. Restart Cursor after install so hooks load.
  2. Health: curl -s "http://127.0.0.1:${CLAUDE_MEM_WORKER_PORT}/api/health" (or the port in ~/.claude-mem/.worker.port).
  3. Do a small unit of work, then open the worker URL. New notes should appear.

​
Troubleshooting

​
Nothing is being stored

  • Confirm the worker is up. Do not restart it if it is already healthy.
  • Confirm you used npx claude-mem install, not a global npm install.
  • Restart Cursor once after install.
  • Logs: ~/.claude-mem/logs/worker-YYYY-MM-DD.log

​
Hooks not firing

Restart Cursor. Hooks live under .cursor/ in the project or your user Cursor config after install.

​
Next steps