How BRB works
BRB keeps local repositories primary, mirrors them to Cloudflare-hosted repo agents, and packages continuity so a new agent can resume instantly.
The product loop
- 1A local repo is registered with BRB.
- 2The CLI or daemon watches file changes and Codex session logs.
- 3BRB batches edits, syncs the delta to a Durable Object-backed repo agent, and creates a remote commit.
- 4Conversation, memory, checkpoints, and sync state become visible in the app.
- 5The next agent resumes from packaged handoff context instead of a cold start.
Main system components
- Local CLI: repo registration, sync, watch, daemon.
- Repo agent: one Durable Object per project.
- Repo directory: registry Durable Object for the project list.
- Workers AI: commit message generation.
- Web app: dashboard, project detail, resume workspace, restore points.
Why local-first matters
BRB mirrors the working tree and continuity state, but it does not auto-commit the user’s local repository. This keeps the developer in control of their own git history while still giving the remote project a durable operational trail.