For the complete documentation index, see llms.txt. This page is also available as Markdown.

Memory

The agent builds a long-term memory of your project - facts, preferences, and knowledge it learns from sessions and files - so it carries context between conversations and gets more useful over time.

Memory is what lets the agent learn. As it works through sessions, reads files, and receives feedback, the agent stores what it learns as memory - and reads it back in later sessions. That means it carries context between conversations: tell it something once, and it remembers next time. Memory is available on selected plans.

How Memory Works

During a session, the agent reads, writes, and searches its memory automatically. You don't need to manage this - it happens as part of the agent's normal work. Memory matures through three layers:

  • Observations - Raw and of-the-moment. Past sessions, reflections, and ingested files.

  • Memories - Distilled and reusable. Facts, preferences, and rules of thumb.

  • Knowledge - Settled reference. Curated articles, skills, and rules.

New information enters at the bottom as observations, gets distilled into reusable memories, and can eventually settle into curated knowledge the agent treats as authoritative reference.

The Memory Explorer

Open Intelligence > Memory in your project to see everything the agent knows. The page shows memory as a layered map - three stacked planes, one per layer, with each document as a node. Related memories cluster together, and lines connect memories to the sessions and files they came from, so you can trace where any piece of knowledge originated.

The map is live: when the agent stores or updates something during a session, the map refreshes on its own.

To find something specific:

  1. Use the search field in the side panel to search across all of memory.

  2. Select a result to open the document and see exactly what the agent has stored.

  3. Click any node on the map to preview that document in place.

You can zoom, rotate, and reset the view using the on-screen controls, and the whole map can be navigated with the keyboard. Summary counts show how much sits in each layer.

Reading and Editing Memory

Anyone with access to the page can read memory documents. Each document shows its content alongside its layer, its type (for example a fact, preference, reference, or article), and when it was last updated.

Users with the Builder role can also change what the agent knows:

  1. Open a document from the map or a search result.

  2. Select the edit control to switch the document into editing mode. Documents are plain markdown.

  3. Make your changes, then choose Save - or Discard changes to leave the document as it was.

Builders can also delete documents the agent should no longer rely on.

💡 Editing memory directly changes how the agent behaves. If it has remembered something wrongly - an outdated fact, a preference that's changed - correcting the document here fixes it for every future session.

⚠️ Deleting a memory removes it from what the agent knows. If you only want to correct a detail, edit the document instead.

Seeding Memory in a New Project

When a project has no memory yet, the Memory page helps you give the agent a head start. You can:

  1. Run a background check - the agent researches your company and stores what it finds.

  2. Connect tools - link the apps you work in so the agent can learn from them.

  3. Upload files - share documents, decks, or notes for the agent to learn from.

As each step completes, you'll see the first memories appear on a live map. You only need one of these to get going - the agent keeps learning from every session after that.

Memory in Chat

While you chat with the agent, a Memory card in the sidebar shows a miniature version of the memory map. When the agent stores something new mid-session, the card animates - zooming in on the new memory so you can see the moment it learns. Select a layer to list its documents, open any of them to read what was stored, or follow the link to the full Memory page.

💡 The more the agent knows, the more useful it is. Mention your preferences, correct it when it gets something wrong, and give it feedback - all of that becomes memory it applies in future sessions.

Last updated

Was this helpful?