> ## Documentation Index
> Fetch the complete documentation index at: https://docs.versuno.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# save_memory

> Save a durable memory to the user's store so every agent can recall it.

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](/mcp/tools/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.

<Warning>
  Never save secrets, tokens, credentials, or personal data. Save durable facts, preferences, decisions, and procedures only.
</Warning>

## Input

| 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:**

```json theme={null}
{
  "content": "The project uses pnpm, never npm.",
  "canonical": "package-manager",
  "type_hint": "fact"
}
```

**Response:**

```
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

* [recall\_memory](/mcp/tools/recall-memory): read memories back, across every agent.
