memory
Store and retrieve persistent AI memories. Use search before adding to avoid duplicates, then update or delete existing memories as needed.
Instructions
Legacy dispatcher for backward compatibility. Use specialized tools (add_memory, search_memory, etc.) instead.
Persistent memory store. Actions: add|search|list|update|delete|export|import|stats|restore|archived|consolidate.
ACTION GUIDE — when to use each:
add: Store NEW information. Requires 'content'. Use when saving preferences, decisions, facts for the first time. Example: action='add', content='User prefers dark mode', category='preference', tags=['ui']
search: Find existing memories by natural language query. Requires 'query'. Use BEFORE add to avoid duplicates. Example: action='search', query='dark mode preference'
update: Modify an EXISTING memory by ID. Requires 'memory_id' (from search/list results). Use when a fact changes. Example: action='update', memory_id='abc123', content='User now prefers light mode'
list: Browse all memories, optionally filtered by category. No query needed.
delete: Remove a memory by ID. Requires 'memory_id'.
stats: Show database statistics (total memories, categories, embedding status).
export: Export all memories to JSONL format.
import: Import memories from JSONL data. Requires 'data'.
archived: List archived memories. Optionally filter by limit.
restore: Restore an archived memory by ID. Requires 'memory_id'.
consolidate: Summarize and consolidate similar memories in a category using LLM. Requires 'category'.
WORKFLOW: search -> not found? -> add. Found outdated? -> update (with memory_id from results). PROACTIVE: save user preferences, decisions, corrections, project conventions.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | ||
| content | No | ||
| query | No | ||
| memory_id | No | ||
| category | No | ||
| tags | No | ||
| source | No | ||
| importance | No | ||
| limit | No | ||
| data | No | ||
| mode | No | merge | |
| text | No | ||
| context_type | No | conversation | |
| auto | No | ||
| since | No | ||
| until | No | ||
| min_importance | No | ||
| include_archived | No | ||
| name | No | ||
| entity_id | No | ||
| depth | No | ||
| as_of | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |