# Co-Located Memory Surfacing

> When a user mentions a known entity, proactively surface the 1–2 most relevant past memories inline — so the agent brings context to the conversation without being asked.

- **Category**: Agentic AI
- **Subcategory**: Memory
- **Canonical URL**: https://designpattern.fyi/patterns/co_located_memory_surfacing/

---

## Description
**Intent**: Surface relevant persistent memories proactively when the human mentions a concrete entity the agent has prior knowledge of — so the human doesn't bear the burden of remembering to ask.
**Context**: The agent has a searchable persistent memory store — thoughts, notes, insights, project files, prior session transcripts. The human's memory of past sessions is fuzzy or absent. The agent can search its own memory in milliseconds; the human cannot search into it at all.
**Solution**: On every user message, extract concrete proper nouns and significant named phrases. Match against persistent memory via grep or embedding similarity. If matches exist, surface ≤ 2 most relevant fragments inline in the reply — time-stamped, briefly framed — and let the human steer whether to pursue. Suppress surfacing if it would feel like a lecture or if the mention was clearly incidental.



## Use Cases
- The agent has a persistent memory store keyed by entities (people, projects, places).
- Users expect the agent to recognize and react to entities they've discussed before, without being prompted.
- Memory recall can be made cheap enough to run on every user turn (lookup, not LLM call).






## Trade-offs


### Advantages

- Conversation continuity across sessions without the user needing to re-explain context.

- The human doesn't have to remember to ask — the agent brings relevant history to them.

- Surfaces forgotten threads naturally, in context.




### Considerations & Drawbacks

- Risk of surfacing irrelevant matches that derail the conversation.

- Context window cost when many matches fire simultaneously.

- Privacy risk if shared memory contains sensitive details from other contexts.







---
**Reference**: [Original Source](https://www.agentpatternscatalog.org/patterns/co-located-memory-surfacing/)