Memory
The Memory tab shows what the agent has learned and remembered about you, your home, and your preferences. Memory is what transforms Aegis from a generic AI into a personalized security assistant that knows your family, routines, and environment.
Open via ⚙️ Settings → Persona → Memory.
How Memory Changes Everything
Without memory, every conversation starts from scratch. The agent sees "a person at the front door" and that's all it knows.
With memory, the same event becomes: "Sarah just got home 20 minutes late. She usually arrives at 5:30pm. Her blue Honda is in the driveway."
Memory gives the agent:
- Identity awareness — know who family members, neighbors, and regular visitors are
- Routine understanding — know what's normal for different times of day
- Contextual alerts — distinguish between "Mom arriving home" and "unknown person at the door"
- Personalized responses — answer questions with context ("That's the FedEx driver — they've been here three times this week")
Memory Files
Memories are stored as categorized text files. The file list shows:
- File path — category and filename (e.g.,
family/members.txt,routines/daily.txt) - Size — how much data is stored
- Modified — when the memory was last updated
Click a file to view its contents (up to 100 lines are displayed).
Common Memory Categories
| Category | What to Store | Example |
|---|---|---|
family | Names, descriptions, vehicles, schedules | "Mom drives a blue Honda Civic, arrives home around 5:30pm" |
routines | Daily patterns, expected events | "Mail delivery typically between 11am-1pm. School bus arrives at 3:15pm." |
visitors | Regular visitors, service people | "Dog walker comes Mon/Wed/Fri at 2pm. Lawn service on Thursdays." |
environment | Property layout, camera coverage | "Front door camera covers porch and first 10 feet of walkway. Driveway camera has blind spot on the left side." |
preferences | Alert preferences, observation priorities | "Only alert for people after 10pm. Ignore cats and raccoons." |
vehicles | Known vehicles | "Black Toyota Camry is mine. White minivan is the neighbor's." |
pets | Animals that live in or near the property | "Golden retriever named Max, often in the backyard. Neighbor has two outdoor cats." |
Adding Memories
Click Add Memory to manually teach the agent something:
- Enter a Category (e.g.
family,routines,preferences) - Enter the Content — what you want the agent to remember
- Click Save
What Makes a Good Memory
Specific and actionable:
- ✅
"Mom usually arrives home around 5:30pm. She drives a blue Honda Civic. If she's not home by 7pm, that's unusual." - ✅
"The UPS driver parks on the street and walks packages to the porch. Don't alert for their brown truck." - ✅
"The backyard camera picks up the neighbor's tree swaying in the wind — this is normal motion, not an intruder."
Too vague to be useful:
- ❌
"I have a family" - ❌
"Cars park near my house" - ❌
"There's a tree"
Automatic Memory
The agent can also be instructed to save memories itself during conversations. If you tell the agent "Remember that my neighbor Mark walks his dog past the driveway twice a day", it uses the Memory Write tool to store this information automatically. You can enable or disable this capability in the Toolbox settings.
Deleting Memories
Individual memory files can be deleted from the file list. Click the delete button next to any file to remove it permanently. This is useful when:
- Information has changed (new vehicle, different routine)
- The agent learned something incorrect
- You want to reset the agent's understanding of a topic
How Memory Is Used
The agent loads relevant memory files into its context when responding to questions and analyzing events. Here's how it works in practice:
| Scenario | Without Memory | With Memory |
|---|---|---|
| Person at front door at 5:30pm | "Person detected at front door" | "Sarah just got home. She's right on time." |
| Unknown person at 2am | "Person detected on driveway" | "⚠️ Unknown person on driveway at 2:03am. No matching family members or scheduled visitors." |
| Package on porch | "Object left on porch" | "Looks like a delivery — the usual FedEx driver was here. Package is medium-sized." |
| Dog in backyard | "Animal detected in backyard" | "Max is playing in the backyard. Normal activity." |
Memory makes the difference between a system that reports raw observations and one that genuinely understands your world.
Tips for Building Effective Memory
- Start with family — add names, descriptions, and vehicles for everyone who lives in the house
- Add routines gradually — as you notice the agent alerting for routine events, teach it what's normal
- Be specific about vehicles — color, make, and model help the agent distinguish between known and unknown cars
- Include schedules — delivery times, school bus arrivals, and work schedules help the agent set expectations
- Update regularly — memory is most effective when it reflects your current situation
- Use the agent — tell the agent things in conversation and let it write memories automatically