The layers

All four entry points call the same Brain object, so a search from the CLI, an MCP tool call and a request to /api/search return the same result.

Three kinds of content

Transcripts do not go into person pages. Store the transcript as a source and link to it.

The index

The index is a SQLite file at .brain/index.sqlite. It is rebuilt when files change and is never committed. The web app does not make a request wait for a rebuild: when files change outside the process, for example after a sync, it serves the previous index and rebuilds in the background.

Who can write what

Every write has an actor. The owner’s writes apply directly. For any other actor: Proposals are JSON files in proposals/ and appear in the web app under Review.