forget

The user wants to remove data from agentmemory: $ARGUMENTS

Quick start

memory_smart_search { "query": "old api key in config", "limit": 20 }

Show the matches, get a yes, then:

memory_governance_delete { "memoryIds": ["abc12345", "def67890"], "reason": "user privacy request" }

Expected output:

Found 2 matching memories. Confirmed. Deleted 2 memories.

Why

This is destructive and irreversible. Show exactly what will be deleted and get an explicit yes before calling delete. Delete by memory ID, never a bare session.

Workflow

1. Search with memory_smart_search, the user's text as query, limit: 20.
2. Show what matched: session ids, memory ids, titles. Ask for explicit

confirmation. Do not proceed on silence or a vague "sure, whatever".

1. On confirmation, call memory_governance_delete with memoryIds (array or

comma-separated string) and optional reason (default plugin skill request).

1. To drop a whole session, collect every memory id in that session from the

search results and pass them all. The MCP does not accept a bare sessionId.

1. Lessons are separate: delete one with memory_lesson_delete and its

lessonId; memory_governance_delete does not touch lessons.

1. Report the deletion count back. A count of 0 means the ids did not exist;

say so instead of claiming a delete.

Anti-patterns

WRONG: search returns matches, you immediately call memory_governance_delete without showing them or waiting for a yes.

RIGHT: list the matches, ask "Delete these 2? (yes/no)", and only delete after an explicit yes.

Checklist

• Matches were shown to the user before any delete.
• An explicit yes was received, not assumed.
• memoryIds holds real ids from the search, never a bare sessionId.
• Final message states the actual count deleted.

See also

• remember: the write side; forget is its undo.
• recall: find the exact memory id before deleting.

Troubleshooting

See ../shared/TROUBLESHOOTING.md if `memorysmartsearch` or `memorygovernance_delete` is not available.