Open-source deterministic orchestrator for CLI coding agents. Runs Claude Code, Codex, Gemini CLI and 40+ agents in parallel git worktrees. No model in the coordination loop, so runs replay byte-identically and a reviewer checks the record offline without rerunning it.
Show off your agentic readiness — the badge auto-updates when your score changes.
llms.txt Content
# Bernstein
> Bernstein is a deterministic orchestrator for CLI coding agents (Claude Code, Codex, Gemini CLI, and 40+ more). Scheduling is plain Python - no LLM in the coordination loop - so runs are reproducible end to end. Every task runs in its own git worktree behind lint/type/test gates. An always-on lineage spine and replay journal record what happened; an opt-in HMAC-chained audit log and signed receipts let a reviewer who did not execute the run check it offline, without rerunning it. Signature and hash-chain checks read the on-disk records alone; the HMAC leg needs the key the chain was written with. Air-gap install profile included. Apache-2.0. Built by Alex Chernysh.
## What you get
State is file-based (`.sdd/`), so there is no server to provision. Per-agent credential scoping keeps each agent's keys out of the others' environments. Pluggable cloud sandboxes, cloud artifact sinks, progressive skill packs, and Cloudflare cloud execution are available on top of the local worktree default.
## Docs
- [Documentation](https://bernstein.readthedocs.io/): Full technical documentation
- [Architecture](https://bernstein.readthedocs.io/en/latest/ARCHITECTURE/): System architecture and design
- [Getting Started](https://bernstein.readthedocs.io/en/latest/GETTING_STARTED/): Installation and quickstart
- [Adapter Guide](https://bernstein.readthedocs.io/en/latest/ADAPTER_GUIDE/): Supported agents and how to add your own
- [API Reference](https://bernstein.readthedocs.io/en/latest/openapi-reference/): Task server REST API
- [Cloudflare Guide](https://bernstein.readthedocs.io/en/latest/cloudflare-overview/): Cloud execution on Cloudflare Workers
- [Configuration](https://bernstein.readthedocs.io/en/latest/CONFIG/): bernstein.yaml reference
- [CHANGELOG](https://bernstein.readthedocs.io/en/latest/CHANGELOG/): Release notes per version
## Site pages
- [Why Bernstein](https://bernstein.run/why-bernstein): Positioning vs LLM frameworks (CrewAI / LangGraph) and CLI orc
OpenAPI Spec (preview)
openapi: 3.0.3
info:
title: Bernstein Task Server API
description: REST API for the Bernstein task server. Bernstein is a deterministic orchestrator for CLI coding agents - reproducible parallel runs, signed audit trail, air-gap friendly.
version: 3.11.0
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0
contact:
name: Alex Chernysh
url: https://github.com/sipyourdrink-ltd/bernstein
servers:
- url: http://127.0.0.1:8052
description: Local t