Local-first · cloud-ready

Use it locally or in the cloud.

Start with the mb CLI — no server, no database, no API key. Create AI build contracts, validate changes into Matrix Commits, and sync to the cloud when you're ready.

The mental model

mb is the git for AI builds.
MatrixHub is the GitHub for bundles.

// LOCAL — track the work
gittracks source code
mbtracks AI build contracts
// CLOUD — host & share
GitHubhosts repositories
MatrixHubhosts validated Matrix Bundles
Quickstart

Start locally in six commands.

Deterministic and offline. Everything lives in .mb/.

terminal
pip install agent-generator
mb init "A GitHub repo intelligence agent" --quality standard
mb next "Add repo ingestion"
mb prompt --coder claude-code        # paste into your AI coder
mb check backend/app/...              # approved → an immutable Matrix Commit
mb timeline
No backend required No database required No API key required
Two ways, one workflow

What's on your disk — and how cloud compares.

.mb/ — your local Matrix history
.mb/
├── project.json // version + cursors
├── blueprint.json // the controlled contract
├── batches/ // scoped change sets
├── prompts/ // per-coder prompts
├── validations/ // pass / repair reports
├── commits/ // immutable Matrix Commits
└── timeline // the full build history
Local-first vs Cloud
Local mbCloud
Drive withterminalbrowser
State in.mb/Postgres + storage
Enginelocal agent-generatorsame engine, API
Setupnoneaccount + backend
Best fordevs, CI, offlineteams, sharing
Syncoptionalbuilt in
They're not separate products — local and cloud run the same workflow model.
The bridge

Work offline. Sync when ready.

Push your local Matrix Commits to the cloud; pull merged state back when your workspace changes.

terminal
mb login        # self-issued session token
mb sync         # push commits ⇄ pull merged state
.mb/ local
offline timeline
Matrix Builder Cloud
accounts · sync
MatrixHub
publish validated
Transparent by default

What works today?

Ready today

Local mb CLI

Offline, deterministic, no infrastructure. The full loop — init, next, prompt, check, repair, timeline.

Ready

Cloud backend

Auth, the control-plane API, workflow tables, validation, repair, and run events — deployed and running.

Being connected

Cloud web UI

The backend exists; the next step is wiring "My Builds" to the API instead of browser storage. Build with mb today.

Why it matters

AI coding needs a history.

Prompts disappear. Chats get messy. AI changes are hard to trust. Matrix Builder gives AI work a timeline you can replay, validate, and verify.

idea → version → batch → prompt → validation → Matrix Commit → repair → timeline

Start local. Grow to cloud.