Cursor Support Now Available 🎉
This is a major release introducing full Cursor IDE support. Claude-mem now works with Cursor, bringing persistent AI memory to Cursor users with or without a Claude Code subscription.
Highlights
Give Cursor persistent memory. Every Cursor session starts fresh - your AI doesn't remember what it worked on yesterday. Claude-mem changes that. Your agent builds cumulative knowledge about your codebase, decisions, and patterns over time.
Works Without Claude Code
You can now use claude-mem with Cursor using free AI providers:
- Gemini (recommended): 1,500 free requests/day, no credit card required
- OpenRouter: Access to 100+ models including free options
- Claude SDK: For Claude Code subscribers
Cross-Platform Support
Full support for all major platforms:
- macOS: Bash scripts with
jqandcurl - Linux: Same toolchain as macOS
- Windows: Native PowerShell scripts, no WSL required
New Features
Interactive Setup Wizard (bun run cursor:setup)
A guided installer that:
- Detects your environment (Claude Code present or not)
- Helps you choose and configure an AI provider
- Installs Cursor hooks automatically
- Starts the worker service
- Verifies everything is working
Cursor Lifecycle Hooks
Complete hook integration with Cursor's native hook system:
session-init.sh/.ps1- Session start with context injectionuser-message.sh/.ps1- User prompt capturesave-observation.sh/.ps1- Tool usage loggingsave-file-edit.sh/.ps1- File edit trackingsession-summary.sh/.ps1- Session end summarycontext-inject.sh/.ps1- Load relevant history
Context Injection via .cursor/rules
Relevant past context is automatically injected into Cursor sessions via the .cursor/rules/claude-mem-context.mdc file, giving your AI immediate awareness of prior work.
Project Registry
Multi-project support with automatic project detection:
- Projects registered in
~/.claude-mem/cursor-projects.json - Context automatically scoped to current project
- Works across multiple workspaces simultaneously
MCP Search Tools
Full MCP server integration for Cursor:
search- Find observations by query, date, typetimeline- Get context around specific observationsget_observations- Fetch full details for filtered IDs
New Commands
| Command | Description |
|---|---|
bun run cursor:setup
| Interactive setup wizard |
bun run cursor:install
| Install Cursor hooks |
bun run cursor:uninstall
| Remove Cursor hooks |
bun run cursor:status
| Check hook installation status |
Documentation
Full documentation available at docs.claude-mem.ai/cursor:
- Cursor Integration Overview
- Gemini Setup Guide (free tier)
- OpenRouter Setup Guide
- Troubleshooting
Getting Started
For Cursor-Only Users (No Claude Code)
git clone https://github.com/thedotmack/claude-mem.git
cd claude-mem && bun install && bun run build
bun run cursor:setupFor Claude Code Users
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem
claude-mem cursor installFull Changelog: v8.2.10...v8.5.0