Skip to main content
The BrowserOS assistant has long-term memory. It remembers your name, your projects, the tools you use, and things that came up in past conversations. You do not need to repeat yourself. The assistant builds up knowledge about you over time and uses it to give better, more relevant answers.

​
How Memory Works

Memory is automatic. As you chat, the assistant saves important facts and observations to local files on your machine. Before responding in future conversations, it searches these files to recall relevant context.

Remembers you

Your name, job, location, projects, and preferences are stored permanently and recalled whenever relevant.

Keeps session notes

Useful details from each conversation are saved as daily notes and kept for 30 days.

Searches before answering

The assistant proactively searches its memory before responding, so it can reference things you have mentioned before.

Stays on your machine

All memory files are plain Markdown stored locally. Memory is never uploaded to the cloud, even with Sync to Cloud enabled.

​
Two Types of Memory

BrowserOS uses a two-tier memory system to keep important facts separate from session notes.

​
Core Memory

Core memory holds permanent facts about you. Things like your name, where you work, what projects you are working on, the tools and languages you use, and people you mention regularly. These facts persist forever and are never automatically deleted. Core memory lives in a single file called CORE.md. When the assistant learns something new about you, it reads the existing core memory, merges the new fact in, and saves the updated file. Examples of what goes in core memory:
  • Your name and role
  • Company and team
  • Projects you are working on
  • Tools, languages, and frameworks you use
  • People you mention often
  • Long-term preferences (“I prefer TypeScript over JavaScript”)

​
Daily Memory

Daily memory holds session notes, observations, and recent events. Each day gets its own file (e.g., 2026-03-07.md), and entries are timestamped so the assistant can see when things happened. Daily memories automatically expire after 30 days. If something keeps coming up, the assistant promotes it to core memory so it is not lost. Examples of what goes in daily memory:
  • Tasks you worked on today
  • Decisions made during a conversation
  • Temporary context (“meeting with Sarah moved to Thursday”)
  • Research findings from a browsing session

​
Memory in Action

You do not need to tell the assistant to remember things. It picks up on important details naturally. But you can also be explicit:
Just mention something in conversation and the assistant decides whether to save it:
  • “I’m working on a project called Atlas at Acme Corp” -> saved to core memory
  • “We decided to go with Postgres instead of MongoDB” -> saved to daily memory
  • “My name is Sarah” -> saved to core memory
Be explicit when you want something remembered:
  • “Remember that our staging URL is staging.example.com”
  • “Save this: the design review happens every Tuesday at 2pm”
  • “Remember that I prefer dark mode in all my tools”
The assistant searches memory automatically, but you can also ask directly:
  • “What do you remember about the Atlas project?”
  • “What did we discuss yesterday?”
  • “Do you know my team members’ names?”
You can ask the assistant to remove specific memories:
  • “Forget my phone number”
  • “Remove the note about the staging URL”
  • “Clear what you know about Project X”

​
Where Memory Lives

All memory files are stored locally on your machine in the BrowserOS data folder:
FilePathPurpose
Core memory~/.browseros/memory/CORE.mdPermanent facts about you
Daily notes~/.browseros/memory/2026-03-07.mdSession notes, auto-expire after 30 days

​
Memory vs SOUL.md

BrowserOS separates what the assistant knows from how it behaves. These are two different systems that work together.

Memory

Facts about you and the world. Your name, projects, preferences, recent events. Stored in CORE.md and daily files.

SOUL.md

How the assistant acts. Personality, tone, communication style, boundaries. Stored in a single SOUL.md file. See SOUL.md for details.
When the assistant learns that you work at Acme Corp, that goes in memory. When it learns that you prefer bullet points over paragraphs, that goes in SOUL.md. This separation means the assistant can change its personality without losing knowledge about you, and vice versa.

​
Privacy

Never leaves your machine

Memory files live on your machine and are never uploaded to any server. Even with Sync to Cloud enabled, memory stays local.

You control what is remembered

Ask the assistant to forget anything at any time. You can also directly edit or delete the memory files.

Plain text files

Memory is stored as readable Markdown. No hidden databases or encrypted blobs. You can inspect everything.

30-day auto-cleanup

Daily notes are automatically deleted after 30 days. Only facts you have promoted to core memory persist.