Benzene

Self-hosted · any model · set up by your coding CLI

Agents that heal, divide and evolve. Work that has to pass.

Benzene runs AI agents as cells. Each cell walks a six-atom ring for every instruction, and a compiler, a test or a document check decides whether the work counts. Cells that keep failing divide. A colony grows into an organisation of six offices, founded in order by its own record, and a heartbeat keeps it running itself.

$benzene plugin start --for claude "build me the best component library"

Pick the CLI, pass the purpose. Claude Code, OpenCode or Codex does the rest: installs, picks your model, writes the manifests, founds the organisation, runs the first check.

The benzene ring: six offices around one cell A hexagon with a vertex for each office: COO orchestration, CTO skills and tools, CIO the model, CFO guardrails, CXO feedback, CMO viability. The CEO's instruction enters from above and light travels around the ring. CEO Instructions · the purpose COOOrchestration CTOSkills & tools CIOThe model CFOGuardrails · quantitative output CXOFeedback loops CMOViability

the ring one instruction, six atoms, in order · light where the work is now · CEO the seat, not a cluster

6offices, founded in order by the record
10verifier types, from a compiler to a weight budget
260offline tests, real compilers in the loop
1process, local files, no telemetry

From one purpose to an organisation

"Build me the best component library."

One sentence becomes one cell. The cell heals against its guardrail, divides when it falls short, founds offices as the product matures, and evolves on analytical feedback until the purpose is delivered. Watch it happen.

A purpose becomes a cell, the cell heals, divides into a cluster, founds six offices, evolves on feedback and delivers the component library
Purposethe CEO's one line enters the ring
Cellsix atoms run in order for every instruction
Drill-downproblem, plan, steps in parallel waves
Healthe guardrail fails, the cell retries, then verifies
Dividea struggling cell splits on its strong and weak skills
FoundCTO, COO, CMO, CXO, CFO, CIO, each on the record
Evolvemetrics and panels feed back; principles stay
Deliverthe library ships; the heartbeat keeps it alive

One cell, six atoms

Every instruction walks the ring

The ring is the whole company inside one cell. At the general scale each atom is an office of many cells; at the universal scale the same six govern galaxies. The titles change with the rung of the ladder. The ring does not.

COO · orchestration

Define, plan, execute, reflect

Every cell states the problem, plans the steps, runs them alone or one session per skill in parallel waves, and writes an honest reflection after the verdict is in.

CTO · skills & tools

Portable skills, real tools

Skills are SKILL.md files any model can follow. Tools write to the workspace, ask an operator, search the web. Verified executions become new skills.

CIO · the model

Any LLM, priced honestly

Anthropic, OpenRouter, a local server. Roles per model: primary, judge, router, evolver, scout, and a decider that routes each instruction to the right office and cell. Free tiers survive outages with fallbacks and retries.

CFO · guardrails

The toolchain decides

Compilers, tests, import resolvers, document structure, claims held to the record, a balance sheet that must add up. A failed verifier caps the score and heals the cell.

CXO · feedback

Two signals, the worse one governs

Guardrail efficacy and world efficacy, each an EMA. The guardrail cannot vouch for work the world rejects, and the world cannot excuse work that fails the guardrail.

CMO · viability

Only verified work is presented

A task is offered to humans only after every verifier passed. The rest stays in the heal loop. Evaluation panels judge the record like a Product Hunt or a Shark Tank.

Work that has to pass

Guardrails that prove themselves

Other frameworks approve agents. Benzene verifies their work. Ten verifier types run the real toolchain after every attempt, and the framework goes further than hand-written checks:

  • The standard comes from research: one subagent per office documents what the competition does, and its bars become the checks the cells heal against.
  • The scout defines a newly divided cell's guardrails with the cheapest model, and proves each check on the clean workspace and on a spoiled copy before it counts.
  • Acceptance criteria on every ticket name their check. A plan nothing can check fails the planner's own guardrail.
  • The ratchet: a failed task never leaves the workspace worse than it found it. Progress the verifiers can see is kept; worse is rolled back.
  • The incrementality test proves a recursive loop improves beat over beat, with a holdout, a trend and a drawdown, and names the blind spots.
Read the guardrail model
# the CTO's genome: the product's own checks
guardrail:
  verifiers:
    - {type: command, name: verify:cli, command: [node, --check, index.js]}
    - {type: sections, files: [skills/*/SKILL.md],
       front_matter: [name, description]}
  require_written_files: true
  pass_threshold: 0.70

# what the scout added, proven on a spoiled copy
guardrail_source: scout:scout_e5d88655
guardrail_evidence:
  - verify:skill-doc: passed clean in 0.1s; failed spoiled

The heartbeat

A healed organisation runs itself

Once the offices have passed their guardrails, nobody has to type instructions. Every office does its duty on its beat, in founding order, and everything flows through the COO. Features wait in the CEO's inbox. Maintenance just happens.

OfficeOn its beatTo the CEO
CTOruns its verifiers on the workspace, fixes what fails, releasesmaintenance done, or needs you
CXOconvenes its panel, studies the experience and the competition, suggests a feature
CFOreads the balance sheet and the growth curve, suggests a changewhen the system burns
CMOreads the CXO's analytics, builds the campaign, asks for product work
CIOcheap panel first, the angel panel when it says yesthe offers
COOresearches the beat, proposes, builds what is approved, measures before and afterapprovals, shipped, improvement reports

Where it sits

Between a hired agent and an org chart

A personal agent

One self-hosted agent with memory and skills, reachable on chat. Grows with you. Nobody checks its work but you.

The Hermes shape.

Benzene

Cells with guardrails that prove the work, an organisation founded by its own record, a heartbeat with a CEO inbox. Self-hosted, one process, any model.

Proof and governance in the same loop.

An org chart of agents

Hire any agent into a role, wake it on a schedule, approve at board level, cap its budget. Governance without a verifier.

The Paperclip shape.

Quick start

Pick the CLI. Pass the purpose.

One command

benzene plugin start --for claude "build me the best component library". Or --for opencode, --for codex. The skill lands where that CLI reads skills and the CLI opens with the request.

The CLI does the setup

It installs what is missing, picks the model from the keys you have, reads the project, writes benzene.yaml and benzene-org.yaml with your purpose, runs the first check and reports which offices are founded. At most two questions.

The manifest lives

Your original stays as written. A cluster block under it records how the cell healed, evolved and divided.

Start the heartbeat

/benzene:heartbeat and /benzene:inbox, or bza --heartbeat --beats 0 --every 3600. Features wait for you; maintenance runs on its own.

$ benzene plugin start --for claude "build me the best component library"
  installed the benzene skill at ~/.claude/skills/benzene · handed over to claude
  OPENROUTER_API_KEY found · wrote benzene.yaml (verify:test, verify:types) and benzene-org.yaml
$ bza
=== round 1: work discovered by verify:types; 1 task(s) by skill efficacy
[CTO] cto took: fix the type error in src/header.tsx ...  passed 0.93  verified
office coo founded: the CTO cluster is healed

$ bza -i "the CLI crashes on init, fix it"
[CTO] cto took: the CLI crashes on init, fix it
  routed by decider (1.00): typesafe/jev-router

$ bza --heartbeat
=== beat 1
  cto  ran   verifiers pass: verify:cli, verify:skills
  coo  ran   the CXO and CFO both point at dark mode
  COO proposes [feature] Dark mode (pending): approve with --approve prop_f27dde47

Run your own organisation of agents. Self-hosted, open source, verified at every step.