Cursor Mind

README

# Cursor Mind – Persistent AI Memory for Cursor

This plugin gives Cursor a persistent “mind” that mimics OpenClaw’s `MEMORY.md` + `SOUL.md` approach.

## What it does
- **extract-and-log** (`/cursor-mind-extract`):
  - Pulls the last N days of chat history from Cursor’s local SQLite storage.
  - Summarises tasks, tools used, and AI effectiveness.
  - Writes a daily markdown file under `~/.cursor-mind/memory/YYYY-MM-DD.md`.
  - Updates a long‑term `MEMORY.md` with a concise bullet.
- **soul** (`/cursor-mind-soul`): Shows the assistant’s personality and guiding principles.
- **add‑note** (`/cursor-mind-add-note`): Append an ad‑hoc note to today’s daily log.

## Where data lives
```
~/.cursor-mind/
├─ MEMORY.md          # long‑term curated memory
├─ SOUL.md            # personality description
└─ memory/
   └─ YYYY-MM-DD.md   # raw daily logs (auto‑generated)
```
All files are plain markdown and can be version‑controlled if you wish.

## Installation
1. Clone the repo (or download the zip) to any location on your machine.
2. In the repo root run:
   ```
   cursor plugins add .cursor-plugin
   ```
   This registers the plugin with Cursor.
3. Restart Cursor (or reload plugins) – the new slash commands will appear.

## Usage
- **Run a full extraction** (default past 14 days):
  ```
  /cursor-mind-extract
  ```
- **Custom days**:
  ```
  /cursor-mind-extract --days 30
  ```
- **Add a quick note**:
  ```
  /cursor-mind-add-note --note 'Discussed UI redesign'
  ```
- **Read the Soul**:
  ```
  /cursor-mind-soul
  ```

## Customising the Soul
Edit `~/.cursor-mind/SOUL.md` to change the assistant’s tone, rules, or emphasis. The next time you run `/cursor-mind-soul` the updated version will be shown.

## Extending / automating
Because the daily logs are just markdown files you can:
- Add a Git hook that `git add ~/.cursor-mind/memory/*.md && git commit -m "daily cursor mind"`.
- Write a simple script that runs `/cursor-mind-extract` on a cron schedule.
- Feed the `MEMORY.md` into other LLMs for long‑term context.

---
*Created by the June personal AI assistant*