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

# Memory

> What a bot remembers, and how you see and change it.

Bots remember. They keep notes as Markdown documents, read them back at the start of each run, and update them as they learn.

## What a bot keeps

* **The bot's own notes.** The main one is `MEMORY.md`, which the bot reads first on every run.
* **Shared memory.** Notes every bot in the space reads and keeps up to date, such as facts about your business.
* **Past chats.** Older conversations are kept where the bot can search them, but they are not loaded into every run.

On each run, the bot loads its most important notes (about 32 KB, with `MEMORY.md` first). It finds older material by searching.

## How bots use memory

Bots save and look things up with built-in tools:

| Tool | What it does |
| - | - |
| `remember` | Adds a fact to the bot's notes. |
| `search_memory`, `read_memory` | Find and read notes. |
| `save_shared_memory` | Updates a note every bot in the space reads. |
| `save_memory`, `recall_memory`, `forget_memory` | Save and recall facts by meaning, when a memory provider is connected. |

You can also just tell the bot: "Remember that we close at 6pm on Fridays."

## See and edit memory

Open the bot's settings and find **Memory**. You can:

* Open a document, edit it, and click **Save**.
* **Download** a document.
* **Delete** documents you no longer want.

**Automatic changes** lists what the bot changed on its own recently. Click **Undo** on any of them.

## Memory upkeep

In memory settings, these switches are on by default:

| Switch | What it does |
| - | - |
| **Notice facts from chats** | Saves useful facts from conversations. |
| **Tidy notes nightly** | Cleans up and reorganizes notes once a day. |
| **Recall notes before replying** | Looks up relevant notes before answering. |
| **Learn about you** | Keeps notes about you as you work together. |

## Memory providers

You can connect a memory provider (Supermemory, Serenity or Honcho) so bots can save and recall facts by meaning, alongside `MEMORY.md`. With a provider connected, you choose a **Default scope**:

* **Isolated**: each bot has its own memories.
* **Shared**: bots in the space share them.

Each bot can follow the default or override it under **Advanced**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.