v3.14.159 shipping40+ cli adapters · apache 2.0 · on-prem

several coding agents. one git tree. every run provable.

bernstein is a deterministic python scheduler that runs cli coding agents in parallel. no model in the coordination loop, so the same plan replays byte-identically.

ships adapters for claude code, codex, gemini cli, aider, and 40+ more. each runs in its own git worktree; lint, types, and tests gate every merge. lineage and replay are always on - flip on the hmac audit log and someone who did not run it can check the record offline, without rerunning it.

ask the docsgrounded in source + 20 postscited

ask anything.

how it works

How does Bernstein work?

Bernstein is an open-source deterministic orchestrator for CLI coding agents. It decomposes a goal into tasks, spawns Claude Code, Codex, Gemini CLI and 45 other agents into isolated git worktrees, runs each task in parallel, then verifies the output through lint, type checks, tests, and an optional cross-model review before merging. The scheduler is plain Python with no model in the coordination loop, so the run replays byte-identically from the always-on replay journal and a reviewer who did not execute it can check the record offline.

one run, four stages.

decompose

manager → tasks · roles · signals

spawn

agents → isolated worktrees

verify

janitor → tests · types · lint

merge

only verified diffs land

from the blog

three pieces from the blog.

field notes from the orchestra pit. hand-picked: what the newest release fixed and what it did not, what running this in the cloud looks like, and how it started.

Aug 10, 20264 min read

bernstein 3.14.159: the stranger's ninety minutes

A first-use report described ninety minutes of setup that ended in nothing. v3.14.159 answers it: the plan loader raises named errors instead of swallowing malformed fields, five commands are removed and the rest fold with deprecation windows, the reference docs are CI-gated against the registered CLI, and the README says beta. Also new: a Muse Code adapter, Agent Plugins v1.0.0 manifests, a signed run receipt that verifies offline, and bernstein audit diagnose.

multi-agent orchestrationreleaseCLIplan validation

Apr 14, 20264 min read

agents on cloudflare: workers, durable objects, r2, d1

bernstein's cloudflare integration for ai coding agents: workers run agents, workflows carry multi-step tasks, r2 + d1 hold workspace and metering state. experimental; runs on your own account.

Cloudflare Workerscloud AI agentsserverless orchestrationmulti-agent orchestration

Mar 29, 20262 min read

bernstein 1.0: open-source orchestrator for ai coding agents

Orchestrate Claude Code, Codex, Gemini CLI and other CLI coding agents in parallel git worktrees. Deterministic scheduler, HMAC-signed audit chain.

multi-agent orchestrationAI coding agentsClaude Codeopen-source

evidence, not vibes

every step signed, in order, on disk.

run with --audit and bernstein writes an hmac-chained event log under .sdd/audit/, one jsonl file per utc day. each entry references the previous hash. tampering breaks verification. nothing leaves your machine.

someone who did not run it can check it. signature and hash-chain checks read the files alone; the hmac leg needs the key the chain was written with, so hand a reviewer both and bernstein audit verify answers without rerunning anything. not a screenshot, not a SOC2 PDF - a hash chain that recomputes.

~/proj $ bernstein audit verify

# reading .sdd/audit/2026-07-24.jsonl · 412 entries · 18m04s span

17:42:01  manager.plan     cb84a1…  13 tasks · est $4.20
17:42:18  scheduler.spawn  3e09f7…  t-001 → backend (sonnet)
17:42:18  scheduler.spawn  81c2dd…  t-002 → backend (sonnet)
17:42:19  scheduler.spawn  b50af8…  t-003 → qa      (opus)
17:55:11  janitor.verify   d014a3…  t-005 docs · pytest 84/84 · ruff 0
17:55:14  manager.merge    ee7c12…  t-005 → main · 4 files · clean
18:02:14  janitor.fail     9aa10b…  t-003 qa · pytest collect err · 3/3 retries
18:02:30  scheduler.route  71b4cc…  t-003 opus → sonnet · awaiting op
18:09:14  scheduler.pause  4d2e09…  conflict · t-001 ↔ t-007 · src/auth/refresh.py

verify chain      ok ✓  412/412 entries · last hash 4d2e09cb…
hmac key          ~/.local/state/bernstein/audit.key

frequently asked

the four questions that block install.

is the scheduler an llm?

the core loop is plain python. who runs, who's blocked, what merges is deterministic and replayable. agents are llms, model selection is llm-assisted (capability router + recommender), best-of-n picks a winner via llm judge. all of those are opt-in and pluggable, so if you'd rather have the planner decide via llm too, you wire your own through the routing layer. just don't put it in the scheduler tick.

does it phone home?

nothing leaves your machine without your config. opt-in telemetry is full and audit-grade when you turn it on: hmac-chained run trail, per-task tool calls, model usage, token cost, latency percentiles. ship it to your own otel collector, datadog, splunk, s3 bucket. defaults to local-only because on-prem installs need that, but the enterprise hooks are there.

where does it run?

wherever you point it. your laptop, on-prem behind a firewall, cloudflare workers as the cloud runtime, kubernetes as a multi-node cluster, or a hybrid of those. sandbox-execution mode is supported (cloudflare sandbox, local docker). your repo is the input, your tests are the gate; bernstein adapts to the host. nothing forces a saas hop.

how is this different from claude code?

claude code can spawn sub-agents on its own; bernstein does the same thing across 40+ different cli agents at once and verifies their output against your tests instead of trusting it. claude code is the most common primary backend inside bernstein - using one does not exclude the other.

one engineering post a month.

what we shipped, what broke, what we learned. one click to unsubscribe.