Skip to main content
Facts that stay true past this session — about the project, the stack, or the people working on it. Call it proactively. When a user reveals a durable preference or fact in passing, that is the moment to write it; waiting to be asked means it is usually never written at all.

Parameters

string
required
The durable fact or preference to store.
'org' | 'agent'
default:"org"
org (default) writes to the shared team memory. agent keeps it private to the identity in the X-Vex-Agent header. See Scope.
string
Optional space slug. Omit to write to the org’s default store.

Examples

Guidance

“We deploy on Tuesdays” is a fact. “We deployed on Tuesday” is an event — that belongs in observe, if anywhere.
Memories are read cold, months later, by an agent with none of your context. “Use the new endpoint” is useless. “The billing service moved to /v2/invoices in June; /v1 is read-only” survives.