cortex-manage

What this skill does

# Memory Management

Help the user manage their Cortex memories.

## Capabilities

### Search and View Memories

Use `cortex_recall` to find specific memories:
- Search by content
- Filter by project
- View memory details

### Update Memory

Use `cortex_update` to edit a memory:
- Update content (will re-generate embedding)
- Move to different project
- Both at once

```
cortex_update(memoryId: 123, content: "corrected content")
cortex_update(memoryId: 123, projectId: "new-project")
```

### Rename Project

Use `cortex_rename_project` to move all memories from one project to another:
- Useful when project directory is renamed
- Bulk operation - moves all memories at once

```
cortex_rename_project(oldProjectId: "old-name", newProjectId: "new-name")
```

### Delete Specific Memory

Use `cortex_delete` to remove a memory fragment:
1. First call WITHOUT `confirm: true` to preview what will be deleted
2. Show the user the preview (content, project, timestamp)
3. Ask for explicit confirmation
4. If confirmed, call with `confirm: true` to delete

### Forget Project Memories

Use `cortex_forget_project` to delete all memories for a project:
1. First call WITHOUT `confirm: true` to get count
2. Show the user how many memories will be deleted
3. Ask for explicit confirmation
4. If confirmed, call with `confirm: true` to proceed

## Important Safety Rules

**ALWAYS follow these rules for destructive actions:**

1. **Preview First**: Always call the delete/forget tool without confirm first
2. **Show Impact**: Display exactly what will be affected
3. **Explicit Confirmation**: Ask user "Are you sure you want to delete X?"
4. **Never Assume**: Don't delete without explicit user approval
5. **Be Clear**: State what will be permanently lost

## Example Flows

### Updating a Memory

User: "Fix the typo in memory 42"

1. First recall to see the memory:
   ```
   cortex_recall(query: "...")
   ```

2. Update with corrected content:
   ```
   cortex_update(memoryId: 42, content: "corrected content here")
   ```

### Moving Memory to Different Project

User: "Move memory 42 to project 'cortex'"

```
cortex_update(memoryId: 42, projectId: "cortex")
```

### Renaming a Project

User: "I renamed my project folder from 'old-name' to 'new-name'"

```
cortex_rename_project(oldProjectId: "old-name", newProjectId: "new-name")
```

### Deleting a Specific Memory

User: "Delete the memory about the auth bug fix"

1. Search for memories about auth bug:
   ```
   cortex_recall(query: "auth bug fix")
   ```

2. Show results and ask which one to delete

3. Preview the deletion:
   ```
   cortex_delete(memoryId: 123)
   ```

4. Show preview to user: "This will delete: 'Fixed auth bug by...' from project X"

5. Ask: "Are you sure you want to delete this memory?"

6. If yes:
   ```
   cortex_delete(memoryId: 123, confirm: true)
   ```

### Clearing a Project's Memories

User: "Clear all memories for the old-project"

1. Preview:
   ```
   cortex_forget_project(projectId: "old-project")
   ```

2. Show: "This will delete 45 memories from old-project"

3. Ask: "This action cannot be undone. Are you sure?"

4. If yes:
   ```
   cortex_forget_project(projectId: "old-project", confirm: true)
   ```

## What NOT to Do

- Never delete without showing what will be deleted
- Never assume the user wants to delete
- Never delete multiple memories without listing them first
- Never forget a project without explicit confirmation