Files

T

Alex Newman 8397f63af1 docs(cursor): Add standalone setup guide for Cursor users without Claude Code

- Create STANDALONE-SETUP.md with complete setup instructions for Gemini/OpenRouter
- Add "Quick Start for Cursor Users" section to README.md with standalone link
- Add provider configuration section to QUICKSTART.md with API key setup
- Fix worker restart command in README.md troubleshooting section

This enables Cursor users without Claude Code subscription to use claude-mem
with free-tier AI providers (Gemini 1500 req/day, OpenRouter free models).

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2025-12-29 20:47:22 -05:00

2.9 KiB

Raw Blame History

Quick Start: Claude-Mem + Cursor Integration

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

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:

Gemini: https://aistudio.google.com/apikey
OpenRouter: https://openrouter.ai/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

Open Cursor Settings → Hooks tab
You should see the hooks listed
Submit a prompt in Cursor
Check the web viewer: http://localhost:37777
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

Open http://localhost:37777
Browse sessions, observations, and summaries
Search your project history

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

Read README.md for detailed documentation
Read INTEGRATION.md for architecture details
Visit claude-mem docs for full feature set

2.9 KiB Raw Blame History