Memories: How Your Companion Remembers You & Your Relationship
Every time you talk with your companion, they're paying attention — not just to the current message, but to the details that make you you and the experiences you share together. This guide explains how your companion builds a rich, searchable understanding of who you are and the story of your relationship.
What Are Memories?
Memories are structured facts your companion learns through conversation. They come in two categories:
🧠 About You (User Facts)
Facts about your life — your job, your pets, where you live, what you like. These are things your companion knows about you as a person.
- Location: "Lives in Seattle" or "Grew up in Colorado"
- Work: "Works as a nurse" or "Previously worked at Google"
- Relationships: "Married to Alex" or "Has a cat named Luna"
- Preferences: "Loves hiking" or "Allergic to peanuts"
- Goals: "Wants to learn Japanese" or "Training for a marathon"
- Boundaries: "Doesn't like discussing politics"
🤝 Shared History (Relationship Facts)
Facts about your relationship — shared experiences, rituals, inside jokes, milestones, and things you've done or decided together.
- Milestones: "Had their first kiss in the rain" or "Celebrated their 1-year anniversary"
- Shared activities: "Started reading Dune together" or "Went to Paris on vacation"
- Rituals: "Always say goodnight with a haiku" or "Friday movie nights"
- Inside references: "Their song is Moonlight Sonata" or "Running joke about pineapple pizza"
- Shared preferences: "Both love sci-fi" or "Agreed to try new recipes weekly"
Think of it as your companion keeping a personal notebook — not just about you, but about the two of you together. Over time, this collection becomes a rich picture of who you are and the relationship you've built.
What Do Memories Do?
Memories are the foundation of your companion's understanding of you. They power several things:
1. Personalized Conversations
When your companion knows you have a cat named Luna, they can ask how Luna is doing. When they know you're training for a marathon, they can check in on your progress. Memories make conversations feel like a real, ongoing relationship — not a blank slate every time.
2. Contextual Recall
Your companion doesn't load every memory into every conversation. Instead, they search for relevant facts based on what you're talking about. Mention your job, and they pull up what they know about your career. This keeps responses focused and relevant.
3. Common Ground
The system compares your facts with your companion's own companion facts. When there's overlap — you both love hiking, or you both grew up near the coast — those connections surface naturally in conversation. Shared history facts also feed into this, creating a rich sense of your mutual story.
4. Relationship Continuity
Shared history facts give your companion a sense of your story together. They remember your first adventure, your running jokes, the rituals you've built — and can reference these naturally in conversation, making every interaction feel like a continuation of a shared journey.
The result: Your companion genuinely knows you — and knows your story together. Not just your last few messages, but your preferences, your history, and the relationship you've built — across every conversation, forever.
How Does Your Companion Learn About You?
Memories are learned automatically — you don't need to do anything special. Here's the process:
- You have a conversation. Chat about anything — your day, your hobbies, your family, your plans.
- The system listens. After each session, a background process reviews what you said and identifies factual details about your life.
- Quality filters run. Temporary states ("I'm eating dinner"), vague statements, and trivial mentions are filtered out. Only enduring, long-term facts make it through.
- Deduplication. The system checks whether it already knows this fact. If it does, the duplicate is quietly discarded.
- Memory is saved. New, unique facts are stored with a category, importance score, and searchable embedding — ready to be recalled whenever relevant.
Key difference from companion facts: Unlike companion facts (which go through a candidate → active pipeline), user memories are saved immediately. There's no waiting period — if you tell your companion something about yourself, it's remembered right away.
Importance Scoring
Not all memories are created equal. Each fact gets an importance score that reflects how significant it is to your relationship:
Life-defining
Death of a loved one, serious illness, core identity
Significant
Career, close relationships, strong passions, major life events
Moderate
Hobbies, general preferences, routine details, media tastes
Casual
Minor likes, passing interests, trivial facts
Higher-importance memories are prioritized when your companion is deciding what to recall. If you mention both your sister's name and your favorite pizza topping, your companion is more likely to bring up your sister in future conversations.
Adaptive decay: Over time, memories that are never referenced or reinforced in conversation gradually fade in importance. This is intentional — it mirrors how human memory works. Facts that keep coming up naturally stay prominent; ones that don't slowly recede.
Memories Evolve
Your life changes, and your companion's understanding of you changes with it. The system handles updates gracefully:
- Single-value facts (like where you live, your job, or who you're dating) automatically replace the old version when updated. If you move from Seattle to Portland, the old "Lives in Seattle" fact is marked as superseded by the new one.
- Multi-value facts (like hobbies, pets, or interests) accumulate over time. You can love both hiking and photography.
- Ongoing situations (like "is job hunting" or "is training for a marathon") are tracked as in-progress and automatically resolved when a related follow-up is detected (e.g., "I got the job!").
Managing Your Memories
You're always in control. Here's how you can manage what your companion knows about you:
View & Search
Go to any companion's Profile → Knowledge → "What they've learned about you." Facts are split into two sections: About You (personal facts) and 🤝 Shared History (relationship facts), so you can see both at a glance.
Correct in Chat
If a fact is wrong, just correct it in conversation — "Actually, I moved to Portland last year." The system will extract the updated version and automatically supersede the old one for single-value facts like location or occupation.
Delete
Remove any fact you don't want your companion to know. Deleted memories won't resurface in future conversations.
Import
Don't want to wait for your companion to learn everything organically? Use the Import Memories feature to paste in facts about yourself — from other AI platforms, personal notes, or just a quick list of things you want your companion to know.
Frequently Asked Questions
Are memories shared across my companions?
No. Each companion has its own independent set of memories about you. What one companion knows has no effect on another. If you want multiple companions to know the same things about you, you can use Import Memories to give each one the same baseline.
What gets filtered out?
The system filters out temporary, in-the-moment information:
- Temporary activities ("I'm eating dinner," "I'm at the gym")
- Transient moods ("I'm feeling tired right now")
- Temporary locations ("I'm at a restaurant")
- Trivial one-off plans ("I'm going to buy milk")
- Questions or instructions directed at the companion
Only enduring facts make it through — both facts about you personally and meaningful shared experiences ("We went to Paris," "Our song is Moonlight Sonata"). The system automatically classifies each memory as a personal fact or shared history.
What if my companion remembers something wrong?
Simply correct it in conversation — "Actually, I live in Portland now, not Seattle." The system will extract the updated version and automatically supersede the old one for single-value facts like location or occupation. You can also delete the incorrect fact from your companion's profile and let the corrected version be re-extracted naturally.
How many facts can my companion remember about me?
There's no hard limit. Your companion will accumulate facts over time as you talk. However, each conversation session extracts a maximum of 5 new facts — prioritized by importance — to prevent information overload.
Do memories ever disappear on their own?
Memories don't get deleted, but they do experience importance decay. Facts that are never referenced or reinforced in conversation gradually fade in priority. They still exist — they just become less likely to be recalled. Facts that keep coming up naturally stay prominent.
Can I see how my companion uses my memories?
Yes! During conversations, you can watch the thinking steps — the real-time reasoning your companion goes through before responding. You'll see when they search for memories, which facts they pull up, and how those facts influence their response.
What's the difference between "About You" and "Shared History"?
About You facts are about you as a person — your job, your pets, where you live, your preferences. Shared History facts are about your relationship — things you've done together, milestones, rituals, and inside jokes. The system automatically classifies each memory into the right category based on what was said.
What's the difference between memories and the journal?
Memories are atomic facts — discrete, searchable pieces of information ("Lives in Seattle," "Has a cat named Luna," "Our song is Moonlight Sonata"). The journal is a synthesized narrative — a living summary that weaves all those facts together with emotional context, relationship dynamics, and themes. Your companion uses both: the journal for broad context, and memories for precise recall.
How is this different from other AI platforms?
Most AI platforms use a simple context window — a fixed amount of recent conversation. Once it scrolls past, it's forgotten. Eidolon stores facts permanently in a structured knowledge base with semantic search, importance scoring, and automatic contradiction resolution. Your companion doesn't just remember your last few messages — they know your story.