# Memory

Bots remember what matters between conversations, and you can read, download or delete anything they
keep.

## What a bot remembers

Each bot writes notes as it works: your preferences, facts about the job, what it tried. Its notes are
indexed in a file called `MEMORY.md`. When a bot's notes outgrow what it keeps in mind at once, it
keeps `MEMORY.md` and a list of its other notes, and opens the rest when it needs them.

A note that has grown long is tidied automatically: duplicates are merged, and a note that a later
one replaced is dropped. Earlier versions are kept, and come with your
[data export](/docs/account/#your-data). Team notes and shared memory are never rewritten this way.

You can also just tell it: "remember that invoices go to the finance folder".

To see what a bot remembers, click its name at the top of the chat and open **Memory** under
**Advanced**. Open a note to **Edit**, **Download** or **Delete** it. `MEMORY.md` itself can be
edited but not deleted.

## Long chats

A bot keeps the recent part of its chat in view and searches older messages when it needs them.
Anything it must always follow belongs in its [instructions](/docs/writing-instructions/); facts it
must not lose belong in memory. Ask "remember that…" when something matters.

## Shared memory

Some things every bot should know, such as your name, your company, or how you like reports
written. Those go in **Shared memory**: every bot in the [space](/docs/spaces/) reads these notes and
keeps them up to date.

Find it in **Settings → Memory** on web, desktop, and mobile. Open a note to read it, then choose
**Edit** to change it, **Download** to keep a copy, or **Delete** to remove it from shared memory.

In a [team space](/docs/teams/#team-spaces), your memory is per person: your shared memory and what a
shared bot remembers about you are yours, and teammates have their own. See
[What's shared in a team space](/docs/team-setup/#whats-shared-in-a-team-space).

## Team notes

A bot in a team space keeps team notes that everyone's chat with it reads. It saves what it learns
about the job there, such as a procedure someone corrects, and says so in the chat. Notes about you
stay in your own memory.

Everyone can read team notes by clicking the bot's name at the top of the chat and opening
**Memory** under **Advanced**, in the **Team** section. The bot's maker and the team's owners and
admins can edit or delete them, and turn **Learn for the team** off.

## Knowledge sources

[Connect Google Drive](/docs/integrations/) first. Then, in a chat you started, ask a bot to learn a
Drive folder by sending its link or ID, and approve the request in the card it shows. Documents
stay in Drive, where Opisense keeps only their titles and folder paths; bots check each document's
current version when they read it, and report deleted or unshared ones as gone. Google Docs,
Sheets, Slides, plain text and PDF files up to 25 MB can be read (PDFs up to 500 pages), but Word
files cannot yet.

Sources are listed under **Settings → Memory → Sources** (swipe a source on iOS to remove it), and
only the person who added a source, or a team's owners and admins, can remove it.

> [!WARNING]
> In a [space](/docs/spaces/) with other members, everyone in it can get answers from a source, read
> through the Drive account of the person who added it. That includes documents they couldn't open
> in Drive themselves. Add only folders everyone in the space may read. If that person leaves the
> space, the source stops working until someone adds it again.

## Memory providers

Optionally, connect a memory service so bots can also recall facts by meaning, not just by reading
their notes. In **Settings → Memory**, open **Memory provider**:

- **Supermemory**: its cloud service, or your own instance.
- **Serenity**: choose **Recall and write**, or **Recall only** to keep it read-only.
- **Honcho**: recalls from a Honcho peer and saves facts to it.

Once connected, a bot is given the few saved facts that best match each message it receives in the
app, and can look for more itself. **Default sharing** decides what bots share in the provider:

- **Separate per bot**: each bot recalls only what it saved. This is the default.
- **Shared in this space**: bots in the space recall from one pool.

Each bot's settings also gain a **Memory scope** under **Advanced**, next to **Computer**, so one bot
can differ from the default. **Default sharing** applies only to the provider; shared memory notes stay shared.

To stop using the provider, open **Memory provider** and choose **Disconnect…**.

## Open work

Separate from memory, each bot keeps a short list of **Open work**: things it has started and not
finished. It is in the bot's settings. You can add items for it, or mark them complete.

## Memory across spaces

Memory never crosses [spaces](/docs/spaces/). A bot in one space can't read notes from another.
