Using Ava's memory, step by step
A hands-on tour of how Ava remembers: what happens when a chat ends, what each part of the Memory page does, and the few words that let you steer it — remember, change, forget.
Ava's memory is what lets her pick up where you left off — your projects, your preferences, the decisions you made, the things you meant to come back to. This guide walks through it in practice. For the ideas behind it, read How Ava's memory works.
If you used Ava before
The first time you open this version, your existing memories are brought across automatically, once. There is nothing to switch on and nothing to set up.
What happens when a chat ends
A chat ends when you start a new one, when it has been quiet for ten minutes, or when you close the app. At that point Ava tidies it into her memory in one step, using your own key:
- A few lines for today, so the day can be looked up later.
- Open threads — anything promised or left unfinished — and threads that are now done get closed.
- Facts worth keeping. What you said is kept straight away. What she only noticed waits for your yes.
Steering it in a chat
You never have to manage memory, but you can steer it in plain words:
- "Remember that I deploy on Fridays only." — kept straight away, as something you said.
- "That has changed: we moved to Postgres." — the new fact replaces the old one, and the old one moves to history with the day it stopped being true.
- "Forget that." — gone for good.
- "What did we work on on 3 November?" — she reads that day.
- "What do you know about my other project, DawnSets?" — she reaches into another project by its name.
The Memory page
Open Memory in the sidebar. The line at the top counts what she knows; the search box searches all of it at once. The page has five tabs.
Waiting for your yes
Things Ava noticed but you never said. They are not used until you agree. For each one: Yes, remember — Edit — or No. If one would replace an older fact, the card shows which. The number beside Memory in the sidebar is how many are waiting. She never stops a chat to ask you about these.
You will also see suggestions here: when something you taught her in one project comes up in another, the card says where, and asks whether this is how you always work. Say yes and it moves to About you, so every project has it.
About you
Facts that follow you into every project, and the core page: a short page about you that Ava reads before every conversation, in every mode. Edit it whenever you like — it has a size limit so it stays quick to read. Every fact shows where it came from, and its history if it has changed. Edit fixes the wording; Forget removes it.
Projects
Each project's own facts. They are used when that project is open, or when you mention it by name. Here you can also:
- Link projects that affect each other ("Link with…"), so they share what is relevant. Unlink any time.
- Moved this project — paste the folder it moved to, and its memory follows.
- Forget this project — removes its facts and threads after asking you. The days stay, because they are what happened.
Open threads
Promises and loose ends Ava carries until they are done, across every project. Add one yourself, mark it done, bring it back, or delete it.
Days
What happened each day, newest first, grouped by project. Press Older days at the bottom to go further back.
Forget everything
At the bottom of the Memory page. It asks once, then removes every fact, the core page, the threads and the days — and the files from earlier versions too. It cannot be undone.
Where it lives
Everything is in the ~/.ava/memory folder on your computer, as plain text files: core.md is the core page, facts/ holds the facts, pending/ what is waiting for your yes, history/ what has changed, threads.md the open threads, and episodes/ the days. You can open and edit them by hand; Ava picks up your changes within seconds. Nothing is uploaded, and passwords and keys are blocked from ever being saved.