AgenticMemory
Write Persistent Agent Memory
CLI Tool Name: memory_write
Writes or updates a persistent fact in the agent memory store. Use this when you want your AI assistant to remember decisions, structural choices, or context across restarts and sessions. Stored locally without an external database.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | yes | Unique fact identifier. Example: 'project_language', 'user_preferred_style'. |
| value | any | yes | Value to store. Can be a string, number, boolean, list, or object. |
| category | string | no | Optional grouping label. Example: 'project', 'preferences'. Defaults to 'facts'. |
Example output
json
{
"status": "success",
"message": "Fact stored successfully.",
"key": "user_preferred_style",
"category": "preferences"
}How to use it
Your AI client calls this tool automatically when instructed to save facts. You can prompt explicitly:
example prompt
Save the fact that I prefer Tailwind CSS to the memory store under the 'preferences' category.
[tip]
Combine this tool with the
memory_read tool to load previously saved facts. To store complete session checkpoints, utilize the memory_checkpoint tool instead.