Guides / Brain
The company brain.
The memory your agents share. It keeps learning while the app is closed, and your data stays on your machine unless you choose a hosted database.
01Setting up the brain for your AI agentsHow an agent connects to the brain and which search mode to pick the first time.02Brains and sourcesWhat a brain is, what a source is, and how the two fit together.03Memory for agents: recall, remember, entity, synthesize, forgetThe five memory actions every connected agent uses, and how to connect agents such as Codex or OpenClaw.04Choosing a database engineThe built-in local engine, Supabase and your own Postgres, and when to switch.05Changing the embedding modelWhat to do when you change embedding models and the stored vectors no longer match.06Spend controlsHow the brain caps what it spends on model calls, and how to raise or remove a cap.07Storage tiersWhere the brain keeps each kind of content, and the renamed settings.08Running serve and sync togetherWhy the local engine allows one writer at a time, and how to run a large sync safely.09Row level securityWhy every brain table should have row level security on, and how to exempt one on purpose.10Securing a shared brainWhat to check before you open the brain to other machines, including client registration.11Connecting PerplexityPerplexity connects over the internet, so the brain has to be reachable over HTTPS.12Shell jobsBackground jobs that run a command, what they are allowed to do, and what the errors mean.13Registering job handlersHow a host app registers the handlers its background jobs call.14Building brain pluginsShipping agent runs as background jobs that survive a crash and resume where they stopped.15Skillpacks that bring in dataHow a skillpack adds a new kind of source, and what to do when one stops loading after an update.16Schema packsCustom page types for your brain, and how to undo a schema change.17Improving a skill automaticallyLetting the brain test and refine a skill, and resuming a run that stopped.18BrainBenchThe test suite that checks whether memory carries over between sessions and between agents.19How search modes are comparedThe statistics behind the search mode comparison, in plain terms.