Yumii remembers in three layers, all local:
| Layer | What it holds | How she uses it |
|---|---|---|
| Facts | Durable things about you — name, preferences, plans | Woven into every conversation's context |
| Sessions | Word-for-word conversation history, searchable | "What did we say about X?" finds the actual exchange |
| Summaries | What each conversation was about, and when | "You last spoke two days ago, about the trip" |
Everything lives in SQLite files under ~/.yumii/memory/. Nothing syncs
anywhere.
How facts happen
Two paths:
- She notices. Every few turns, a background review reads the recent exchange against what she already knows and applies careful edits — new facts added, outdated ones corrected, contradicted ones removed. It's a curator, not a transcript: only durable things get stored.
- You tell her. "Remember that my sister's birthday is next month" saves it immediately through her own memory tool. "Forget that" and "actually, it's in March" work the same way — she can correct and delete her own memory on your word.
Both paths land in the same store, visible in Dashboard → Memory. If it's not on that list, she doesn't know it.
Recall: searching the past
Her long-term memory isn't just facts — she can search every conversation you've ever had, full-text, and read the surrounding exchange:
"What was that Python bug we discussed last week?"
She finds the real messages, with timestamps, and answers from them. Nothing is ever silently forgotten; old conversations just stop taking up space in her attention until asked for.
Correcting and forgetting
| Want to… | Do |
|---|---|
| Fix a fact she got wrong | Tell her — or Dashboard → Memory → Edit |
| Remove one fact | "Forget that" — or Dashboard → Memory → Forget |
| Delete one conversation | Dashboard → Chats → Delete |
| Wipe everything | Quit Yumii, delete the ~/.yumii folder |
What's in the files
| File | Contents |
|---|---|
~/.yumii/memory/yumii.db | Session list, summaries, and the searchable transcript |
~/.yumii/memory/checkpoints.db | Full per-session conversation state |
~/.yumii/memory/store.db | The fact store |
Ordinary SQLite — open them with any SQLite browser. Back up memory/ and
you've backed up your entire relationship; move it to a new machine and she
remembers you there.
Privacy note
Facts and retrieved history are included in the context sent to your configured LLM provider during conversation — that's how she uses them. They're never sent anywhere else.