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:
- •First call WITHOUT
confirm: trueto preview what will be deleted - •Show the user the preview (content, project, timestamp)
- •Ask for explicit confirmation
- •If confirmed, call with
confirm: trueto delete
Forget Project Memories
Use cortex_forget_project to delete all memories for a project:
- •First call WITHOUT
confirm: trueto get count - •Show the user how many memories will be deleted
- •Ask for explicit confirmation
- •If confirmed, call with
confirm: trueto proceed
Important Safety Rules
ALWAYS follow these rules for destructive actions:
- •Preview First: Always call the delete/forget tool without confirm first
- •Show Impact: Display exactly what will be affected
- •Explicit Confirmation: Ask user "Are you sure you want to delete X?"
- •Never Assume: Don't delete without explicit user approval
- •Be Clear: State what will be permanently lost
Example Flows
Updating a Memory
User: "Fix the typo in memory 42"
- •
First recall to see the memory:
codecortex_recall(query: "...")
- •
Update with corrected content:
codecortex_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"
- •
Search for memories about auth bug:
codecortex_recall(query: "auth bug fix")
- •
Show results and ask which one to delete
- •
Preview the deletion:
codecortex_delete(memoryId: 123)
- •
Show preview to user: "This will delete: 'Fixed auth bug by...' from project X"
- •
Ask: "Are you sure you want to delete this memory?"
- •
If yes:
codecortex_delete(memoryId: 123, confirm: true)
Clearing a Project's Memories
User: "Clear all memories for the old-project"
- •
Preview:
codecortex_forget_project(projectId: "old-project")
- •
Show: "This will delete 45 memories from old-project"
- •
Ask: "This action cannot be undone. Are you sure?"
- •
If yes:
codecortex_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