# cursor-supermemory

Persistent AI memory for Cursor — powered by [Supermemory](https://supermemory.ai).

## Install

Install from the [Cursor Marketplace](https://cursor.com/marketplace), then authenticate:

```bash
bunx cursor-supermemory@latest login
```

## What it does

- **MCP tools** — 5 tools available in every Cursor AI session:
  - `supermemory_search` — search past memories
  - `supermemory_add` — save new memories
  - `supermemory_profile` — get your user profile
  - `supermemory_list` — list recent memories
  - `supermemory_forget` — delete a memory
- **Session hooks** — automatically injects relevant memories at session start; saves conversation highlights at session end
- **Always-on rule** — reminds the AI to use memory tools proactively

## Configuration

| Variable | Description |
|---|---|
| `SUPERMEMORY_API_KEY` | API key (highest priority) |
| `CURSOR_USER_EMAIL` | Used for user container tag |
| `CURSOR_PROJECT_DIR` | Used for project container tag |
| `SUPERMEMORY_DEBUG` | Set to `1` for debug logging |

Project config: `.cursor/.supermemory/config.json` (add to `.gitignore`)

## Development

```bash
bun install
bun run build   # compiles all dist/ files
```