Brains alphaGitHub

Local-first / MCP-native / Human-governed

Shared context for your agents.
Decisions stay with you.

Brains gives AI coding agents one place to coordinate tasks, leave handoffs and ask for help. You see the work and answer the decisions that need a human.

Start with QuickstartExplore the docs

Alpha software for one local operator. Open source, under the MIT License.

First use / from your project directory
# Python 3.11 or 3.12, with pipx installed
pipx install brains-ai
brains-ai setup --path . --no-wire
brains-ai wire --tool claude-code
brains-ai serve-all

Open http://127.0.0.1:8787/app.
Keep the generated admin key private. Complete setup guide

SQLite on your machine4 harnesses connected over MCP89 MCP tools in the supported coreNo model routing or provider proxy

Agents start cold.
Your work shouldn't.

A new terminal should not mean a new understanding of the project. Brains keeps coordination in a shared local store, rather than scattered across separate tool histories.

Keep the context

Workspaces scope the work. Sessions, checkpoints and handoffs preserve what changed and what comes next.

Continue with one agent

Split the work

Claim before editing, ask a peer for review and attach evidence to the answer. Claims coordinate agents; they do not lock your filesystem.

Coordinate two agents

Keep human authority

Route questions and governed actions through explicit decisions. Inspect the audit chain without mistaking it for a security sandbox.

Handle asks and approvals

One store.
The tools you already use.

Connect Claude Code, Copilot CLI, Codex or OpenCode. Brains coordinates their work; each harness still owns its model connection and execution.

At the command line

The brains-ai executable handles setup, coordination and local operations.

CLI reference

Inside your agent

The brains_ tools share tasks, knowledge, peer help and proof-bound local mail.

MCP tool inventory

In your browser

The local console at /app lets you inspect Workspaces, coordination and governance.

Open and verify the console

Running this day to day? Read Operations for trust boundaries, upgrades, Windows service reinstallation and verified backups.

Latest release

What changed in the published product. The complete recent history now has its own release page.

Latest release: v1.6.0

  • feat: synchronize release highlights with public site by @mekjr1 in https://github.com/xibodev/brains-ai/pull/28
All release notes