memory

The memory tool performs all user-facing memory operations. The required command parameter selects the action.

view

Show all memory, or filter by section.
{"command": "view"}
{"command": "view", "section": "work"}

add

Add a fact to a section.
{"command": "add", "section": "personal", "fact": "Lives in Berlin"}
Structured compact facts are accepted when a client needs stable keys:
{"command": "add", "section": "user_preferences", "key": "answer_style", "value": "Prefers concise answers"}

upsert

Add a structured fact or replace the existing fact with the same key.
{"command": "upsert", "section": "user_preferences", "key": "answer_style", "value": "Prefers concise and direct answers"}

remove

Remove a fact by its one-indexed line number within a section.
{"command": "remove", "section": "work", "line": 3}

replace

Replace a fact by its one-indexed line number within a section.
{"command": "replace", "section": "top_of_mind", "line": 1, "fact": "Working on new project"}

memory_context

The memory_context tool returns memory for session initialization hooks. By default it returns the full formatted memory document. Clients with small context windows can request compact output, section filters, and a maximum character count.
{}
{"format": "compact", "sections": ["user_profile", "user_preferences"], "maxChars": 1500}

Sections

The valid section keys are:
  • work
  • personal
  • top_of_mind
  • history
  • instructions
  • user_profile
  • user_preferences
  • eyra_project
  • devices_environment
  • workflows
  • writing_style
  • long_term_tasks
  • do_not_forget