Expand description
The memory tool — the agent’s autonomous write path into durable
semantic memory.
Reading needs no tool: the memory index is always in context and the full
facts are fetched with read_file on the listed paths. This tool changes
memory (plus one lookup verb):
remember— create a new atomic fact.update— replace one fact’s body (clean replace, never a merge).forget— delete a fact.search— find facts by keyword across names/descriptions/bodies.
The directory chosen by scope is authoritative (private by default,
shared/global opt-in). Writes are ungated in every safety mode except
read-only (see ToolCategory::Memory in the policy engine) — there is no
approval modal — so the gate here only blocks read-only.