save_memory
Saves a Markdown note to global or session memory.
Writes a note with a title, optional tags and the text. Global notes are shared by all chats. Session notes belong to one chat.
- Tool name
- save_memory
- Group
- Memory
- Risk
- low
- Needs approval
- never
- Approval rule
- No approval. Writes inside the memory folder only.
- Allowed in scheduled jobs
- No
- Default
- on
Parameters
| Name | Type | Required | Default | Meaning | Limits |
|---|---|---|---|---|---|
| content | string | Yes | The text to store or write. | Memory notes are read back into prompts in slices of 4,000 characters (global) or 1,500 (session). | |
| title | string | Yes | A short title for the note. | Cut to 200 characters for notifications. | |
| scope | string | Yes | Where the note lives: global (all chats) or session (this chat). | One of: global, session. | |
| tags | array | No | Optional labels. |
Returns
A confirmation with the saved path.
Example (made up for this page)
{
"content": "demo",
"title": "demo",
"scope": "global"
}Saved note 'deploy-notes' to global.Side effects
- Creates or updates a Markdown file on disk.
How it can fail
| When | What the agent sees |
|---|---|
| The content is empty | An error text saying content is needed |
See also:Memory tools
Checked against the source at commit f4fd89f on 29 Oct 2026. Everything here is merged on the main branch; no release has been tagged yet. The source is private, so these pages are the public description.