) Research

Research

Notes from the Supermemory team on memory, retrieval, and how agents work with files.

01 · Memory May 2026

State-of-the-Art in agent memory

  • Recall@k
  • LongMemEval
  • Performance

Supermemory achieves 95% Recall@15 with aggregation while adding only ~720 tokens — a 99.4% context reduction. High recall with minimal overhead across all six LongMemEval categories.

Read full paper
State-of-the-art
Recall@k
SS – Assistant
95% 98% 100%
SS – User
95% 97% 97%
Knowledge Update
93% 94% 99%
Multi-session
85% 90% 93%
Temporal Reasoning
79% 87% 91%
SS – Preference
63% 84% 90%
Overall 86% · ~190 mean tokens · 99.8% context reduction Overall 91% · ~450 mean tokens · 99.6% context reduction Overall 95% · ~720 mean tokens · 99.4% context reduction
LongMemEval_s · 500 questions · 6 categories · with aggregation
02 · File Systems May 2026

SMFS: Memory as a filesystem

SMFS cuts cumulative token usage by 3× on Claude and 1.75× on Codex — while improving task accuracy. A purpose-built filesystem for agents, with structures and commands designed for how they actually work.

Cumulative tokens xAFS · 110 questions
FS × gpt-5.5
84M ±11M
SMFS × gpt-5.5
48M ±8.6M
FS × claude-opus-4.7
72M ±11M
SMFS × claude-opus-4.7
24M ±1.9M
0 25M 50M 75M 100M
3.0× fewer tokens on Claude · 1.75× on Codex
FS × Codex
SMFS × Codex
FS × Claude
SMFS × Claude

Cumulative tokens across all 110 xAFS questions, summed per agent-condition. Lower is better.

Browse all research papers
Features

How a prompt becomes a memory.

Every prompt enters Supermemory with conversation metadata, is enriched with static and dynamic context retrieved from a living graph, and lands at the model with the right memories attached.

Conversation Metadata
customId: conversationID
containerTag: organizationID

metadata: {
  "userId": "xyz",
  "isPersonal": true,
  "team": "xyz"
}
Agent / Client
PromptUser input
Supermemory System
01/Static contextSupermemory prepares this
02/Dynamic contextRelevant memories from graph
Hook
/v4/p?query
Tool
/v4/search
03/Final promptPrompt construction
Supermemory Graph
Entities
Memories
Contexts
customId = conversationID(thread — so far)
Supermemory enables agents to build persistent, structured memory by combining static context with dynamic, relevant memories retrieved from a connected graph.