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.