Files
claude-mem/cursor-hooks/QUICKSTART.md
T
Alex Newman ed8269250d docs(cursor): Add marketing copy and value proposition messaging
Add compelling marketing copy to Cursor documentation with consistent
messaging across all files:

- README.md: Added headline, "Why Claude-Mem?" section, quick install
- STANDALONE-SETUP.md: Added tagline and enhanced value props
- QUICKSTART.md: Added tagline and benefit statement
- docs/public/cursor/index.mdx: Added card grid highlighting benefits

Key messaging themes:
- "Persistent AI Memory for Cursor"
- "Your AI stops forgetting"
- "Free tier options available"
- "Works with or without Claude Code"

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-29 21:09:00 -05:00

3.1 KiB

Quick Start: Claude-Mem + Cursor Integration

Give your Cursor AI persistent memory in under 5 minutes

What This Does

Connects claude-mem to Cursor so that:

  • Agent actions (MCP tools, shell commands, file edits) are automatically saved
  • Context from past sessions is automatically injected via .cursor/rules/
  • Sessions are summarized for future reference

Your AI stops forgetting. It remembers the patterns, decisions, and context from previous sessions.

Don't Have Claude Code?

If you're using Cursor without Claude Code, see STANDALONE-SETUP.md for setup with free-tier providers like Gemini or OpenRouter.


Installation (1 minute)

# Install for current project
claude-mem cursor install

# Or install globally for all projects
claude-mem cursor install user

# Check installation status
claude-mem cursor status

Configure Provider (Required for Standalone)

If you don't have Claude Code, configure a provider for AI summarization:

# Option A: Gemini (free tier available - recommended)
claude-mem settings set CLAUDE_MEM_PROVIDER gemini
claude-mem settings set CLAUDE_MEM_GEMINI_API_KEY your-api-key

# Option B: OpenRouter (free models available)
claude-mem settings set CLAUDE_MEM_PROVIDER openrouter
claude-mem settings set CLAUDE_MEM_OPENROUTER_API_KEY your-api-key

Get free API keys:

Start Worker

claude-mem start

# Verify it's running
claude-mem status

Restart Cursor

Restart Cursor to load the hooks.

Verify It's Working

  1. Open Cursor Settings → Hooks tab
  2. You should see the hooks listed
  3. Submit a prompt in Cursor
  4. Check the web viewer: http://localhost:37777
  5. You should see observations appearing

What Gets Captured

  • MCP Tool Usage: All MCP tool executions
  • Shell Commands: All terminal commands
  • File Edits: All file modifications
  • Sessions: Each conversation is tracked

Accessing Memory

Via Web Viewer

Via MCP Tools (if enabled)

  • claude-mem provides search tools via MCP
  • Use search, timeline, and get_observations tools

Troubleshooting

Hooks not running?

  • Check Cursor Settings → Hooks tab for errors
  • Verify scripts are executable: chmod +x ~/.cursor/hooks/*.sh
  • Check Hooks output channel in Cursor

Worker not responding?

  • Check if worker is running: curl http://127.0.0.1:37777/api/readiness
  • Check logs: tail -f ~/.claude-mem/logs/worker-$(date +%Y-%m-%d).log
  • Restart worker: npm run worker:restart

Observations not saving?

  • Check worker logs for errors
  • Verify session was initialized in web viewer
  • Test API directly: curl -X POST http://127.0.0.1:37777/api/sessions/observations ...

Next Steps