Docs

Built-in tools›Long-term memory

Edit global memory

edit_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.edit_global_memory.description

Changes one passage of an existing global memory document and rewrites its line in the memory index, once you approve it.

The model uses it to correct or extend what it saved in ~/.mework/memory/ (%USERPROFILE%\.mework\memory\ on Windows). New documents are made with create_global_memory. 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

  • After the change, the document can be at most 256 KiB and MEMORY.md at most 64 KiB.

Good to know

  • You can edit the documents in any editor too. The model sees your change the next time it reads the document.

Parameters

ParameterTypeDetails
description required
Description
stringOne-sentence index entry describing the document after the change.
name required
Name
stringExisting document name; the .md suffix is optional.
new_text required
New text
stringReplacement text; an empty string deletes the passage.
old_text required
Original text
stringPassage to replace; must occur exactly once in the document.

Edit this page on GitHub