chore(release): v8.5.0 - Cursor Support Now Available

🎉 Major release introducing full Cursor IDE support

New Features:
- Cursor IDE integration with native hook system
- Interactive setup wizard (bun run cursor:setup)
- Works without Claude Code using Gemini (free) or OpenRouter
- Cross-platform: macOS, Linux, Windows (PowerShell)
- Context injection via .cursor/rules directory
- Project registry for multi-workspace support
- MCP search tools for Cursor

Documentation:
- Full docs at docs.claude-mem.ai/cursor
- Gemini and OpenRouter setup guides

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

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

.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
   "plugins": [
     {
       "name": "claude-mem",
-      "version": "8.2.10",
+      "version": "8.5.0",
       "source": "./plugin",
       "description": "Persistent memory system for Claude Code - context compression across sessions"
     }

CHANGELOG.md

@@ -4,6 +4,122 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
+## [8.5.0] - 2025-12-30
+
+# 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 `jq` and `curl`
+- **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 injection
+- `user-message.sh/.ps1` - User prompt capture
+- `save-observation.sh/.ps1` - Tool usage logging
+- `save-file-edit.sh/.ps1` - File edit tracking
+- `session-summary.sh/.ps1` - Session end summary
+- `context-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, type
+- `timeline` - Get context around specific observations
+- `get_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](https://docs.claude-mem.ai/cursor):
+- Cursor Integration Overview
+- Gemini Setup Guide (free tier)
+- OpenRouter Setup Guide
+- Troubleshooting
+
+## Technical Improvements
+
+### New Utilities Module (`src/utils/cursor-utils.ts`)
+Extracted testable pure functions for:
+- Project registry management
+- Context file operations
+- MCP configuration
+- JSON utilities with array access support
+- Cross-platform path handling
+
+### Comprehensive Test Suite
+New test files validating Cursor integration:
+- `cursor-registry.test.ts` - Project registry operations
+- `cursor-context-update.test.ts` - Context file management
+- `cursor-hooks-json-utils.test.ts` - JSON parsing utilities
+- `cursor-mcp-config.test.ts` - MCP configuration
+- `cursor-hook-outputs.test.ts` - Hook script output validation
+
+### Atomic File Writes
+Context files use temp-file-plus-rename pattern to prevent corruption during updates.
+
+## Getting Started
+
+### For Cursor-Only Users (No Claude Code)
+
+```bash
+git clone https://github.com/thedotmack/claude-mem.git
+cd claude-mem && bun install && bun run build
+bun run cursor:setup
+```
+
+### For Claude Code Users
+
+```bash
+/plugin marketplace add thedotmack/claude-mem
+/plugin install claude-mem
+claude-mem cursor install
+```
+
+---
+
 ## [8.2.10] - 2025-12-30
 
 ## Bug Fixes

package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-mem",
-  "version": "8.2.10",
+  "version": "8.5.0",
   "description": "Memory compression system for Claude Code - persist context across sessions",
   "keywords": [
     "claude",

plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-mem",
-  "version": "8.2.10",
+  "version": "8.5.0",
   "description": "Persistent memory system for Claude Code - seamlessly preserve context across sessions",
   "author": {
     "name": "Alex Newman"

plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-mem-plugin",
-  "version": "8.2.10",
+  "version": "8.5.0",
   "private": true,
   "description": "Runtime dependencies for claude-mem bundled hooks",
   "type": "module",