Anneal

You write the specs. It clears the board.

Anneal runs chains of coding agents on your own machine. Queue tasks on the board, and each one is planned, reviewed, implemented, verified and merged unattended, on the Codex and Claude subscriptions you are already signed in to.

Install · How it works · Status · 简体中文

Live capture: Anneal clearing its own task board. This repository is built by Anneal itself.

The workflow it is built for

You do one thing: write specs. You queue them on the board, Anneal breaks them down and orchestrates the work, and you walk away. A chain picks up each task and takes it the whole way through plan, plan review, implementation, two independent code reviews, fix application, regression verification, and the merge itself. When you come back, the board is clear: you read the pull requests that matter, open an agent window on the ones you care about, and iterate until you are satisfied.

In between, nothing needs you. A chain only stops when a human decision is needed: an agent asks a question through the web Inbox, a step you marked as gated waits for your call, or a run escalates. Once you answer in the Inbox, the board moves on.

What you get

• Spec in, merge out. A task card becomes a branch, a pull request and a merge behind the merge gate. Every intermediate artifact (plan, review findings, fix dispositions, regression results) is recorded on your machine, so you can trace any chain step by step afterwards.
• Nothing merges on faith. Two blind code reviews, an independent regression run, and a merge gate stand between an agent's diff and your main branch.
• Parallel by default. Chains for different projects, repositories and tasks run at the same time. Concurrency is bounded by your machine's resources and your subscription's rate limits; registering more runners raises throughput.
• Your subscriptions, no keys. Anneal launches the official Codex CLI, Claude Code and Pi you have already installed and signed in to. It holds no credential of its own, runs no proxy, and there is no key to paste in.

Anneal is built with Anneal

The pull requests in this repository are specified, planned, reviewed, implemented and merged by Anneal's own chains, running on one local machine. Chain-delivered commits carry Co-Authored-By: Anneal Chain and X-Anneal-Run / X-Anneal-Step trailers, so you can check in the git log which commits the chains produced.

How it works

A chain instantiates a template of steps. Each step binds an agent role: a prompt, a model, a reasoning effort and the runner CLI it executes on. The flagship Full Assurance template covers delivery in twelve steps.

The template is data, not code. Roles, prompts, models and gates are all editable, so you can define your own agent roles and reshape the chain into a workflow for your own team of agents.

Agents: a role, a prompt, a model and effort, and the runner it goes to.

A finished chain: twelve steps done, including four autonomous merge-tail repairs during regression verification.

The design rule behind the steps: whoever wrote the code never judges it. Authorship, review and verification run in separate sessions, the two code reviews cannot see each other's findings, and step 8 adjudicates both. Each session starts clean, with a purpose-built prompt and an environment the runner constructs itself: your global agent config and skills never leak in as noise. Role bindings live in agents/templates/compound-engineer-workflow/; board column semantics in the task-routing contract.

Quick start

You need:

• an Apple Silicon Mac
• Node.js satisfying ^20.19.0 || ^22.13.0 || >=24; use 22.17.0 from .nvmrc, with npm 10.9.2+
• Docker Compose and Git
• the official Codex CLI signed in under the same macOS account (Claude Code and Pi optional)

git clone https://github.com/mosonlab/anneal.git
cd anneal
git checkout v0.6.0
npm ci
npm run setup:local
npm run build
docker compose up -d --wait --wait-timeout 60 postgres
npm run db:migrate:release -- --fresh

Then start npm run dev:api, npm run dev:runner and npm run dev:web in three terminals, in that order, and open http://127.0.0.1:5173. The full sequence with its preflights is in docs/release/developer-preview.md.

Status

Developer Preview 6 (v0.6.0): interfaces and stored data shapes may change between previews, and the only upgrade path is a fresh install. macOS on Apple Silicon only.

Read before pointing this at anything you care about: Anneal launches coding CLIs with non-interactive permission bypass, as your macOS user, outside a sandbox. Use a disposable repository and a machine you are willing to let an agent modify. Details in docs/release/security.md.

Provider CLIs, their authentication and their plan terms stay between you and the provider; the authoritative support statement is docs/release/support-matrix.md.

Documentation

Architecture · Install · Security · Migration and recovery · Release notes · Contributing · Support

Credits and license

Five skills from mattpocock/skills (MIT, Copyright (c) 2026 Matt Pocock) supply working text for the chain's prompts; see THIRD_PARTY_NOTICES.md. This snapshot is licensed under the MIT License, with its boundary defined by public-snapshot.json.

Community link: LINUX DO — sincere, friendly, united, and professional.