Skip to content
Persistent Context

Brain

The workspace that remembers you.


Persistent Brain is stored as human-readable Markdown in workspace/BRAIN.md. A background consolidation process runs every 5 conversation messages, merging new facts with existing memory using the local LLM. The consolidated summary is injected into every chat session automatically.

Key capabilities

  • Memory stored in workspace/BRAIN.md - readable and editable any time
  • Automatic consolidation every 5 messages (configurable)
  • Injected into every chat session without manual steps
  • Agent can read and update memory explicitly via read_brain_memory and update_brain_memory tools
  • Structured sections: User Profile, Active Projects, Preferences, Technical Constraints