Remember

remember

Persist something the user asked you to keep.

Default: observe (let the engine extract)

For almost everything, call memory_observe with the user's raw statement. The engine runs deterministic extraction and saves what's memorable — you don't judge.

{ "name": "memory_observe",
  "arguments": { "text": "<the user's exact statement>", "role": "user",
                 "projectId": "<git repo name or null>", "userId": "<OS user>" } }

Verbatim: save (rare)

Only when the user says "save this exactly / verbatim" or you have structured data the extractor would mangle, use memory_save with an explicit id, type, and scope:

{ "name": "memory_save",
  "arguments": { "id": "<21+ char id>", "platformId": "local", "type": "preference",
                 "scope": "user", "content": "prefers pnpm over npm" } }

Pick scope: user (personal preference/identity), project (a repo's rule/ decision/fact), else let the engine default.

After saving

Briefly confirm what was stored and at which scope, so the user can correct it. If they're changing an existing fact, see the pin/correction note: observe the new statement and let the engine supersede — don't delete.