Remember a durable fact
brain_rememberAppend a durable owner fact—preference, correction, project constraint, or reference—to the memory file so it informs brain_identity and can replace outdated facts.
Instructions
Append one durable fact about the owner to their memory file: a preference, a correction on how to work, a project constraint, or a reference. It becomes part of brain_identity immediately. Include why it matters and how to apply it. When it changes an earlier fact, pass replaces with that fact's id (the stamp in its heading, e.g. '2026-09-22 18:21'): the old fact stays in the file as history and leaves brain_identity. For a fact with one current value, pass subject and attribute (e.g. 'JobMail' and 'database'); a later fact with the same pair replaces it on its own. Use valid_until for something temporary and valid_from when it became true earlier than now. Near-duplicates of current facts are refused, and a fact that looks like it changes a current one is held back until you say whether it replaces it; pass force=true to store it as is. Do not store session trivia.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"fact": "<fact>",
"category": "<category>"
},
"name": "brain_remember"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| why | No | ||
| fact | Yes | ||
| force | No | Store even if it looks like a duplicate or a change to a current fact | |
| subject | No | What the fact is about, e.g. 'JobMail' or 'the owner'. Pass with attribute. | |
| category | Yes | user = who they are; feedback = how to work with them; project = ongoing work; reference = pointer | |
| replaces | No | Ids of current facts this one makes outdated, e.g. ['2026-09-22 18:21'] | |
| attribute | No | Which property of the subject, e.g. 'database' or 'employer'. Pass with subject. | |
| valid_from | No | When it became true, if earlier or later than now: YYYY-MM-DD or YYYY-MM-DD HH:MM (UTC) | |
| valid_until | No | When it stops being true, for temporary facts: YYYY-MM-DD (holds through that day) or YYYY-MM-DD HH:MM (UTC) | |
| how_to_apply | No |