Create global memory

create_global_memory

Group: Long-term memory
Turned on by: The memory switches on the Advanced tools page of Conversation settings.
Approval: Reviewed: writes and open-ended actions ask for approval unless the security level or an earlier “Always allow” covers them.
Profile key: tool.create_global_memory.description

Saves a new document to your global memory and adds its one-line description to the memory index, once you approve it.

The document goes to ~/.mework/memory/ (%USERPROFILE%\.mework\memory\ on Windows), and its description becomes a line in MEMORY.md, which is in context on every run while Enable global memory is on. See Memory and instructions.

When it asks you

Every call asks, at every security level, even when a hook allows it. The card's title, in the app's language, says the change affects memory shared by every project, and there is no Always allow.

Limits

A write that would grow MEMORY.md past 64 KiB fails.

Good to know

Mework maintains MEMORY.md: each write rebuilds it from its index lines and drops anything else. Put standing instructions in ~/.mework/MEWORK.md instead.
To make the model forget something, delete its file in ~/.mework/memory/. From the next run the model no longer sees it in the index.

Parameters

Parameter	Type	Details
`content` required File content	string	The document's complete Markdown body, up to 256 KiB of UTF-8.
`description` required Description	string	One-sentence index entry written into MEMORY.md.
`name` required Name	string	New document name inside the memory directory; no path separators, the .md suffix is optional.