Quick Start

1. Download and install

Download the desktop app for your platform from the download page and run the installer.

• Windows — run the .exe installer
• macOS — open the .dmg and drag Agent Brain to Applications
• Linux — install the .deb package

Before you start:

• Docker Desktop or Docker Engine with Compose must be running

2. Start the stack

Launch Agent Brain. On first run the onboarding wizard walks you through Docker verification and stack startup. Click Start Stack in the dashboard when ready.

Expect the first launch to take 30–60 seconds while services start.

Before connecting an agent:

• Wait for all service indicators to turn green

3. Connect Claude Code

Add this MCP server to your Claude configuration:

{
  "mcpServers": {
    "agent-brain": {
      "type": "http",
      "url": "http://localhost:3100/mcp"
    }
  }
}

Then:

1. Restart Claude Code.
2. Run /mcp.
3. Confirm Agent Brain appears in the tool list.

4. Store your first memory

Ask your agent to remember something durable:

Remember this: our deployment process requires staging approval before production releases. Tag it as an operating rule.

Result:

• Agent Brain stores the memory
• Other connected agents can reuse it

5. Recall it from another session

Start a fresh session or switch to another connected agent:

What database do we use for persistent storage?

Result:

• The agent retrieves the memory without you restating it