Writes one durable memory to the user’s unified store so every other agent (Claude Code, Claude Desktop, ChatGPT, Codex, and others) can recall it later with recall_memory. Use it when you learn something worth remembering across sessions and tools: a stable fact, a preference, a decision, or a how-to procedure.
The store dedups automatically and flags contradictions, so you do not need to check for repeats first.
Never save secrets, tokens, credentials, or personal data. Save durable facts, preferences, decisions, and procedures only.
| Parameter | Type | Required | Description |
|---|
content | string | Yes | The memory to remember, written as a clear standalone statement. |
canonical | string | No | Optional short title for the memory. |
type_hint | string | No | Optional kind: fact, preference, episode, or procedure. |
source | string | No | Optional app you are writing from, e.g. claude-desktop, chatgpt. |
Example
Prompt:
“Remember that this project uses pnpm, never npm.”
Tool call:
{
"content": "The project uses pnpm, never npm.",
"canonical": "package-manager",
"type_hint": "fact"
}
Saved to memory (id 7f77fde0-a8c5-4018-8fef-441b5e3eece9).
What happens to your write
Every write runs through a dedup check, and the tool tells you the outcome:
- New: a fresh memory, recallable immediately by any agent.
- Merged: identical to an existing memory, so nothing is duplicated.
- Conflict: it contradicts an existing memory. Both are kept, and the tool says so. Surface the conflict to the user and let them resolve which is correct in Versuno.
When to use it
- You learned a durable fact, preference, decision, or procedure worth carrying across sessions and tools.
- The user says “remember this” or states a standing rule.
- Do not use it for transient task state, or for anything sensitive.
See also
