> ## Documentation Index
> Fetch the complete documentation index at: https://docs.heygaia.io/llms.txt
> Use this file to discover all available pages before exploring further.

# How GAIA Remembers

> GAIA learns who you are so you never have to repeat yourself

export const Chat = ({messages = []}) => {
  const css = `
.docs-imsg-list {
  display: flex;
  flex-direction: column;
  gap: 4px;
  margin: 1.25rem 0;
}
.docs-imsg-bubble {
  word-wrap: break-word;
  line-height: 24px;
  position: relative;
  padding: 8px 20px;
  max-width: 85%;
  border-radius: 20px;
  font-size: 0.875rem;
  white-space: pre-line;
}
.docs-imsg-bubble::before {
  content: "";
  position: absolute;
  bottom: 0;
  width: 20px;
  height: 18px;
}
.docs-imsg-from-them {
  background: #27272a;
  color: #fafafa;
  align-self: flex-start;
}
.docs-imsg-from-them::before {
  left: -7px;
  background-color: #27272a;
  clip-path: path("M 20 0 L 20 2 A 16 16 0 0 1 4 18 L 0 18 L 0 17.54 A 10 10 0 0 0 7 8 L 7 0 Z");
}
.docs-imsg-from-me {
  color: black;
  background: #00bbff;
  align-self: flex-end;
}
.docs-imsg-from-me::before {
  right: -7px;
  background-color: #00bbff;
  clip-path: path("M 0 0 L 0 2 A 16 16 0 0 0 16 18 L 20 18 L 20 17.54 A 10 10 0 0 1 13 8 L 13 0 Z");
}
.docs-imsg-no-tail::before {
  display: none;
}
.docs-imsg-group-gap {
  margin-top: 8px;
}
`;
  return <div className="docs-imsg-list not-prose">
      <style>{css}</style>
      {messages.map((msg, idx) => {
    const from = msg.from === "user" ? "me" : "them";
    const next = messages[idx + 1];
    const prev = messages[idx - 1];
    const lastOfGroup = !next || next.from !== msg.from;
    const newGroup = prev && prev.from !== msg.from;
    const classes = ["docs-imsg-bubble", `docs-imsg-from-${from}`, lastOfGroup ? "" : "docs-imsg-no-tail", newGroup ? "docs-imsg-group-gap" : ""].filter(Boolean).join(" ");
    return <div key={idx} className={classes}>
            {msg.text}
          </div>;
  })}
    </div>;
};

GAIA remembers things about you across every conversation. Mention your sister once, and GAIA knows her forever. Tell it where you live, and it never asks again. The more you talk, the less you explain.

It all happens automatically. You never have to say "remember this" — GAIA picks up on what matters and keeps it.

<Frame>
  <img className="rounded-lg" src="https://mintcdn.com/gaia-a3e7b78f/4l92QK4YUod-2T5t/images/guides/memory/memory-folders.png?fit=max&auto=format&n=4l92QK4YUod-2T5t&q=85&s=87bd6f1a80d799564c39e94d6c105fbd" alt="Memory settings showing folders with stored facts organized by topic" width="1146" height="1289" data-path="images/guides/memory/memory-folders.png" />
</Frame>

## Four kinds of memory

Everything GAIA learns about you lives in one place: **Settings > Memories**. There are four tabs, each showing the same memory a different way.

### Facts

Individual things GAIA knows about you. Each one is a single, specific fact.

* "Sam's email is [sam@example.com](mailto:sam@example.com)"
* "You prefer concise communication"
* "Your birthday is March 14th"

GAIA adds these automatically during conversations. If you mention something and it changes later ("I moved to Austin"), GAIA quietly updates the existing fact. Nothing is double-stored, and contradictions resolve to whatever you said most recently.

Facts are grouped into **folders** by topic — relationships, work, preferences, and so on. GAIA creates folders on its own as it learns.

### Journal

A short diary entry for each day you've had a conversation. The Journal shows you what happened when — which topics came up, what GAIA helped with, what it learned.

<Frame>
  <img className="rounded-lg" src="https://mintcdn.com/gaia-a3e7b78f/4l92QK4YUod-2T5t/images/guides/memory/memory-journal.png?fit=max&auto=format&n=4l92QK4YUod-2T5t&q=85&s=ad9d8cc526005ddb7414a64f3b1732b7" alt="Journal tab showing a timeline of conversation summaries grouped by day" width="1146" height="1289" data-path="images/guides/memory/memory-journal.png" />
</Frame>

You can browse back through time and see how GAIA's understanding of your life has built up. Each entry is created automatically at the end of a conversation.

### Documents

GAIA keeps a small set of auto-written documents that it reads at the start of every conversation. Think of them as living notes about you:

* **user.md** — who you are, where you work, where you live, how you like to communicate
* **memory.md** — a summary of what GAIA has learned so far
* **people.md** — the people in your life and how they connect
* **agenda.md** — your current priorities and what's on your plate
* **insights.md** — patterns GAIA has noticed about your habits and preferences

<Frame>
  <img className="rounded-lg" src="https://mintcdn.com/gaia-a3e7b78f/4l92QK4YUod-2T5t/images/guides/memory/memory-documents.png?fit=max&auto=format&n=4l92QK4YUod-2T5t&q=85&s=eefc3e3dd984409ee6babb17e2f789fd" alt="Documents tab showing the user.md profile document with identity, work, and location sections" width="1146" height="1289" data-path="images/guides/memory/memory-documents.png" />
</Frame>

GAIA keeps these documents up to date as it learns. You can also edit them directly — click **Edit** on any document to make changes yourself.

### Graph

A visual map of the people, places, and projects in your life, and how they connect. If GAIA knows you have a co-founder, and it knows your co-founder has an email address, those appear as connected nodes.

<Frame>
  <img className="rounded-lg" src="https://mintcdn.com/gaia-a3e7b78f/4l92QK4YUod-2T5t/images/guides/memory/memory-graph-view.png?fit=max&auto=format&n=4l92QK4YUod-2T5t&q=85&s=26f0ec4f3532b11f94f2d58ac8fd8473" alt="Graph tab showing a network visualization of entities and relationships" width="1146" height="1289" data-path="images/guides/memory/memory-graph-view.png" />
</Frame>

The graph is useful for getting a bird's-eye view of what GAIA knows. You can zoom, pan, fit to screen, and export it as a PNG or SVG.

## How memory gets updated

<Chat
  messages={[
{ from: "user", text: "I just moved to Austin" },
{ from: "gaia", text: "Got it, I've updated your location. Is there anything you need help with in Austin?" },
{ from: "user", text: "my new email at work is alex@newcompany.com" },
{ from: "gaia", text: "Noted, I've updated your work email." },
]}
/>

You never have to ask GAIA to remember something. It captures facts from context automatically — during conversations, when you mention people, when you share preferences. If something changes, just say so. GAIA replaces the old information; it doesn't keep both.

<Tip>
  The more you use GAIA across integrations, the richer its memory becomes. A
  conversation where you message someone on Slack teaches GAIA their handle for
  good.
</Tip>

## You're in control

Everything GAIA knows about you is visible and editable in **Settings > Memories**.

* **View** any fact, document, or journal entry
* **Edit** a fact or document if something is wrong or outdated
* **Forget** any individual memory with the delete button
* **Clear all** memories to start fresh

<Warning>
  Clearing all memories cannot be undone. GAIA will re-learn from future
  conversations, but everything it knows today will be gone.
</Warning>

Memory is per-account and private. No other user can see your memories, and nothing is shared with third-party services. Everything is stored and processed within GAIA's own infrastructure.