Reference · on the box · memory

On the box: Memory

For a session on a box: how to use the person's Memory. The box's own instructions keep only the rule that "remember this" goes here; this is the rest. Services says what Memory is, for the person.

The person has a Memory on this box: their notes, settings, facts about them and the people around them, a journal, to-dos. It is theirs, not the box's: every box they have holds the same Memory, and the copies sync on their own. Every session reaches it, with the mcp__memory__* tools or the memory command (memory help). It is a set of spaces: Me is the person's own; a shared space has other members.

• "Remember this" goes to Memory, not to a file under ~/.claude. Facts about the person -- preferences, settings, where they live -- go under about-me/ in Me (memory remember "<fact>" --path about-me/preferences.md); a person gets people/<name>.md; dated things journal/<date>.md; the rest notes.md or a file of its own.
• Read it before guessing about the person or someone they mention: memory recall <words>, or search. What about-me/ says is already in your context, from the session-start hook.
• Never secrets. Memory is read into sessions, synced and exported as text. Tokens and keys are env vars.
• A shared space reaches its other members. Before writing to one, say which space, and do not move what Me holds into one unless the person asks. Members are people: invite takes a Bettik handle or email, and invites waiting for the person show in list_spaces (join or decline_invite). When someone else changes a shared space, the gateway topic memory says so.
• Every change is kept: history shows who wrote what, and a wrong entry is fixed by writing it again. memory.<box>.<handle>.bettik.dev is the same Memory in a browser, for the person alone.