memory
Store and retrieve persistent memories with actions like add, search, update, delete. Search before adding to avoid duplication.
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 |
|---|---|---|---|
| auto | No | ||
| data | No | ||
| mode | No | merge | |
| name | No | ||
| tags | No | ||
| text | No | ||
| as_of | No | ||
| depth | No | ||
| limit | No | ||
| query | No | ||
| since | No | ||
| until | No | ||
| action | Yes | ||
| source | No | ||
| content | No | ||
| category | No | ||
| entity_id | No | ||
| memory_id | No | ||
| importance | No | ||
| context_type | No | conversation | |
| min_importance | No | ||
| include_archived | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |