Skip to main content
Use agent memory to preserve a working preference across sessions. Shared project facts belong in Workspace Knowledge; room rules belong in the room guideline.

1. Read current memory

This returns the persona and structured entry manifest. Read a relevant entry’s body with memory entry read <slug>.

2. Add a durable entry

The command returns a unique slug. Use that returned slug in later commands rather than assuming how a duplicate title will be named. Choose preference, feedback, reference, or context. Restrict --applies-to to a room or person only when the preference would be unhelpful elsewhere. A preference describes behavior; it does not schedule a weekly report. Use a follow-up or Automation to schedule work.

3. Recall and validate

Entries are advertised in the agent’s context; selected bodies are loaded within a budget and other entries can be read on demand. Review updates the validation date after a real check. If the preference changes, use review --verdict update with the new content, or delete an obsolete entry. A repeatable procedure with a clear trigger belongs in a skill. See memory for the complete reference.