Brain Framework¶

Keep the context. Continue the work.

Brain Framework gives you and your agents a shared memory in files you own. Find why a decision was made, resume a project after a break, or give a teammate the evidence they need to act. The same knowledge stays available when you change editors or agent hosts.

Markdown notes hold decisions and reusable knowledge; JSON Lines records hold what optional sensors gathered from selected sources. Brain Framework searches both offline and returns readable refs to the original files. You or your agent interpret the evidence and update the notes after work.

Start with one decision worth remembering. Search it, read its source, and keep the note current as the project changes. Sensors are optional: a shared repository of useful notes is already a working knowledge brain.

Small parts, ordinary tools¶

Use your editor for notes, Git for review, provider CLIs for authentication and a native timer for collection. Brain Framework contributes one command, a rebuildable SQLite cache and two read-only MCP tools. It requires no model, hosted database or background server. Search matches words, explicit identities and dates; it does not generate answers or automatically learn from conversations.

These docs describe Brain Framework 9.2.0. Read the changelog for release changes. Check bf --version and follow the installation guide to update an older copy.

Start with the question you need to answer¶

The brain layout, command reference, configuration schema and security model cover the details when you need them.