Skip to content

Memory UI

The Memory page (/memory) provides a visual interface for exploring an agent’s stored memories. The page has five tabs: Explore, Timeline, Search, Knowledge Graph, and Stats.

Use the agent dropdown (top left, next to the title) to switch between agents’ memory stores. Each agent has a completely separate memory. A Generate from Chats button processes chat history into structured memory episodes with embeddings.

The default Explore view renders memory episodes as a 3D star field (nebula). Each point represents a memory cluster:

  • Position: determined by semantic similarity (similar memories cluster together)
  • Size: proportional to cluster importance
  • Color: varies by cluster, with a color indicator shown in the inspector
  • Brightness: fades for older, less-accessed memories

Interact with the nebula:

  • Rotate: click and drag
  • Zoom: scroll wheel
  • Click a cluster: opens the cluster in the inspector panel (right side), showing topic badges and contained episodes
  • Click an episode: opens full content in the inspector with related memories

The inspector panel includes breadcrumb navigation so you can trace back through cluster-to-episode drill-downs.

The Timeline view provides a chronological feed of all memory episodes. Click any episode to view its full content and related memories in the inspector.

The search panel supports:

  • Keyword search: exact term matching using FTS5
  • Semantic search: similarity-based using vector embeddings
  • Hybrid: combined (default)

Results are ranked by relevance and shown with highlighted matches. Clicking topic badges on clusters automatically populates the search query.

The Knowledge Graph tab renders entities extracted from memories and their relationships as a force-directed graph:

  • Nodes: entities (person, project, concept, tool, file, location, event, other) color-coded by type
  • Edges: relationships between entities with type labels and strength percentages
  • Drag nodes to rearrange the layout
  • Click a node to see entity details, mention count, and connected entities in the inspector

The Stats view shows aggregate memory metrics for the selected agent — total episodes, clusters, entities, and usage over time.