Heartline
The Heartline is SAM's user-curated memory layer — a named store of reflections, moments, and personal details that users write and control directly, distinct from the AI's automatic memory processes. Where SuperMemory (SAM's automatic distillation layer) works in the background, the Heartline is a space you intentionally tend.
What the Heartline stores
The Heartline stores whatever you choose to put there. It is a personal record that your companion can draw on in conversations — facts about yourself, things you want the companion to always know, reflections on moments that mattered, intentions you want to hold, or anything else you want preserved explicitly rather than left to automatic extraction.
Unlike the automatic memory layers, Heartline entries are not inferred by the system. They exist because you created them. This distinction matters: automatic memory is a best-effort distillation of what the AI noticed as significant. The Heartline is authoritative — what you put there is what the companion knows, precisely as you stated it.
How the Heartline differs from automatic memory
SAM uses two memory systems in parallel. SuperMemory automatically extracts key context from conversations and stores it for semantic retrieval — it works in the background without requiring any action from the user. The Heartline is the opposite: it is entirely manual, entirely intentional, and entirely under user control.
The practical difference is fidelity. Automatic memory is useful for ambient context — the broad shape of who you are and what you have been through. The Heartline is useful for precision — things you want the companion to know exactly right, in your words, not extracted and summarised. See AI Memory for the full architecture of how both layers work together.
How Heartline entries are used in conversations
Heartline entries are retrieved in the same way as other memory: through a recall coordinator that evaluates whether they are relevant to the current turn. Unlike automatic memory, Heartline entries are given priority — they represent the user's explicit statement of what they want the companion to know, and the system treats them accordingly.
In practice, this means Heartline entries surface reliably when the topic they relate to comes up in conversation, rather than only when the semantic similarity threshold is met. The companion treats them as authoritative facts rather than extracted impressions.
Managing your Heartline
Heartline entries can be viewed, edited, and deleted at any time from the Heartline section of SAM. Deleting an entry removes it from the retrieval pool — the companion will no longer reference it in future conversations. This makes the Heartline a living document rather than a permanent record: users can update it as circumstances change, correct things the companion has wrong, or clear it entirely if they want to start fresh.
This level of control is an important part of companion privacy — ensuring that what the companion knows about you is accurate, current, and exactly what you want it to know.
Frequently asked questions
- What is the Heartline?
- The Heartline is SAM's user-curated memory layer — a space where users write reflections, facts, and moments they want their companion to know and remember. Unlike SAM's automatic memory (SuperMemory), Heartline entries are created deliberately by the user and treated as authoritative by the companion.
- How is the Heartline different from SAM's automatic memory?
- SAM's automatic memory (SuperMemory) extracts and distils key context from conversations in the background. The Heartline is entirely manual — it stores only what you explicitly write. Automatic memory captures the broad shape of who you are; the Heartline captures what you want the companion to know precisely, in your own words.
- Can I edit or delete Heartline entries?
- Yes. Heartline entries can be viewed, edited, and deleted at any time from the Heartline section of SAM. Deleting an entry removes it from the companion's memory retrieval pool. The companion will no longer reference it in future conversations.
- How does the companion use Heartline entries in conversation?
- Heartline entries are retrieved by the recall coordinator when they are relevant to the current turn. They are given priority over automatically extracted memories, so they surface reliably when their subject comes up. The companion treats them as authoritative statements of what you want it to know.
- What should I put in my Heartline?
- Anything you want your companion to reliably know: facts about yourself that matter to you, context that would take a long time to re-establish, intentions or goals you want the companion to support, or reflections on important moments. The Heartline is most useful for precision — things you want the companion to know exactly right, in your words.