cursor-supermemory 1.0.0

package/hooks/hooks.json

@@ -0,0 +1,18 @@
+{
+  "hooks": {
+    "sessionStart": [
+      {
+        "type": "command",
+        "command": "bun run \"${CURSOR_PLUGIN_ROOT}/dist/session-start.js\"",
+        "timeout": 20
+      }
+    ],
+    "sessionEnd": [
+      {
+        "type": "command",
+        "command": "bun run \"${CURSOR_PLUGIN_ROOT}/dist/session-end.js\"",
+        "timeout": 30
+      }
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "cursor-supermemory",
+  "version": "1.0.0",
+  "description": "Persistent AI memory for Cursor — powered by Supermemory",
+  "type": "module",
+  "bin": {
+    "cursor-supermemory": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "bun build ./src/cli.ts --outfile ./dist/cli.js --target node && bun build ./src/mcp-server.ts --outfile ./dist/mcp-server.js --target node && bun build ./src/hooks/session-start.ts --outfile ./dist/session-start.js --target node && bun build ./src/hooks/session-end.ts --outfile ./dist/session-end.js --target node",
+    "typecheck": "tsc --noEmit",
+    "dev": "bun run src/cli.ts"
+  },
+  "dependencies": {
+    "supermemory": "^4.11.1"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5"
+  },
+  "files": ["dist", "rules", "skills", "commands", "hooks", ".cursor-plugin", ".mcp.json"],
+  "keywords": ["cursor", "supermemory", "mcp", "memory", "ai", "plugin"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/supermemoryai/cursor-supermemory"
+  }
+}

package/rules/supermemory.mdc

@@ -0,0 +1,21 @@
+---
+description: Supermemory persistent memory tools — use them proactively
+alwaysApply: true
+---
+
+You have access to Supermemory MCP tools for persistent memory across coding sessions:
+
+- `supermemory_search`: Search before answering questions about previous work, bugs, or patterns
+- `supermemory_add`: Save decisions, fixes, preferences when user asks or when clearly valuable
+- `supermemory_profile`: Get aggregated user profile and preferences
+- `supermemory_list`: List recent memories for this project
+- `supermemory_forget`: Delete a specific memory by ID
+
+When to use:
+- User mentions past sessions, previous work, or "last time" → search first
+- User says "remember", "save this", "don't forget" → add immediately
+- After solving a hard bug → save the solution and root cause
+- Discovering architectural patterns or conventions → save them
+- User asks why something was done a certain way → search for context
+
+Scope: use `project` for codebase-specific knowledge, `user` for cross-project preferences.

package/skills/memory-init/SKILL.md

@@ -0,0 +1,13 @@
+---
+name: memory-init
+description: Deep codebase exploration to initialize project memory. Use when starting work on a new project or when user asks to "index" or "learn" the codebase.
+---
+
+1. Explore the project structure: read package.json, README, main entry points
+2. Identify: tech stack, framework, architecture patterns, key directories
+3. Find conventions: naming, testing approach, build system, deployment
+4. Read core files to understand data models and business logic
+5. Save architecture summary: call `supermemory_add` with type=architecture
+6. Save tech stack: call `supermemory_add` with type=project-config
+7. Save key conventions: call `supermemory_add` with type=learned-pattern
+8. Confirm: "Codebase indexed — [N] memories saved about [project name]"

package/skills/memory-save/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: memory-save
+description: Save important information to persistent memory. Use when user explicitly asks to remember something, or when you've solved a significant problem worth preserving.
+---
+
+1. Extract the key insight, decision, or solution to save
+2. Choose scope: `project` for codebase-specific, `user` for personal preferences
+3. Choose type: preference, architecture, error-solution, project-config, learned-pattern, or conversation
+4. Call `supermemory_add` with concise, searchable content
+5. Confirm to user that the information has been saved

package/skills/memory-search/SKILL.md

@@ -0,0 +1,9 @@
+---
+name: memory-search
+description: Search persistent memory for relevant information from past coding sessions. Use when user asks about previous work, past bugs, architectural decisions, or anything that may have been worked on before.
+---
+
+1. Call `supermemory_search` with a focused query based on what the user is asking about
+2. If results found, surface relevant memories in your response with context
+3. If no results found, note that no prior memory exists for this topic
+4. For broad questions, try both project scope and user scope