anneal README

The project's README from github.com/mosonlab/anneal. As one markdown file: README.md.

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.

status license platform node

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

Multiple tasks running in parallel across the board

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

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 view: each agent's role, model, reasoning effort and runner

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

The twelve steps in full: role, runner, model and effort for each

An agent's title names the role only — Planner, Code Reviewer, Senior Dev — while its slug spells out role-model-effort, so two agents that do the same job on different models stay distinguishable at a glance.

# Step Agent role What it does Runner Model · effort
1 Write a spec spec-opus-high Turns the task into the specification of record Claude Claude Opus 5 · high
2 Plan plan-fable-medium Cuts the spec into parallel vertical tracer-bullet slices Claude Claude Fable 5 · medium
3 Plan review review-coordinator-astra-medium Reviews every slice against the spec and the frozen base Codex GPT-6 Astra · medium
4 Revise plan plan-reviser-opus-medium Edits the slice set against the findings, in a fresh session Claude Claude Opus 5 · medium
5 Implementation plan-executor-astra-low Executes the slice set from the live dependency frontier and opens the pull request Codex GPT-6 Astra · low, with GPT-5.6 Luna · max subagents
6 Code review code-reviewer-sol-high Reviews the integrated diff at the pinned base and head Codex GPT-5.6 Sol · high
7 Blind code review code-reviewer-opus-medium Reviews the same diff again, blind to step 6's findings Claude Claude Opus 5 · medium
8 Apply review fixes senior-dev-astra-low Dispositions every finding from both reviews and applies the adopted ones Codex GPT-6 Astra · low
9 Documentation librarian-luna-xhigh Updates internal documentation to match the delivered code Codex GPT-5.6 Luna · xhigh
10 Regression verification regression-verifier-luna-max Refreshes onto the target branch and reruns the regressions Codex GPT-5.6 Luna · max
11 Merge readiness — Recomputes the head, requires head-bound regression PASS evidence and a server-side ancestry check, emits an exact-head authorization — mechanical, no model run
12 Merge execution merge-integrator Re-verifies every precondition against the live pull request, then merges — mechanical, no model run
Task detail: a completed twelve-step chain with each step's role and status, the run cost, and the merge-tail repair timeline

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

The verified release path needs:

macOS on Intel is expected to work but is not yet release-verified; Windows is unsupported.

git clone https://github.com/mosonlab/anneal.git
cd anneal
git checkout v0.8.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 8 (v0.8.0): interfaces and stored data shapes may change between previews, and the only upgrade path is a fresh install. The verified targets are macOS on Apple Silicon and Linux (Ubuntu 24.04 LTS, x86_64). macOS on Intel is expected to work but is not yet release-verified; Windows is unsupported.

For the pull-request workflow, follow Add a project.

Read before pointing this at anything you care about: Anneal launches coding CLIs with non-interactive permission bypass, as your own user account, 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.

anneal (mosonlab/anneal)

Searching Database…

187 ·GitHub
Anneal
Что это?Anneal — локальная система оркестрации, которая запускает цепочки кодинг-агентов на вашей машине: вы пишете спецификацию, ставите её в очередь на доске, а дальше её планируют, ревьюят, реализуют, проверяют и мержат без вашего участия, используя ваши собственные подписки Codex и Claude Code.
Это CLI-инструмент или локальный сервис с интерфейсом?Это локальный многопроцессный сервис: API, раннер и веб-приложение, запускаемые отдельно, плюс доска в браузере, где вы ставите задачи в очередь, и веб-инбокс для вопросов, которыми агенты эскалируются к вам.
Как запустить его у себя на машине?Склонируйте репозиторий и запустите npm run dev:api, npm run dev:runner и npm run dev:web в трёх отдельных терминалах именно в таком порядке, затем откройте веб-доску.
Нужны ли API-ключи для Codex и Claude или достаточно войти в аккаунт?API-ключи не нужны: Anneal запускает уже установленные Codex CLI, Claude Code и Pi, в которые вы вошли под своей подпиской, и не хранит собственных учётных данных или прокси. Также нужны Node (^20.19/^22.13/>=24), Docker Compose и Git.
Насколько это стабильно — можно ли доверить ему важный проект?Пока нет — это Developer Preview 8: интерфейсы и сохранённые данные могут меняться между превью, причём единственный путь обновления — установка с нуля; кроме того, CLI запускаются с обходом разрешений вне песочницы, поэтому README рекомендует одноразовый репозиторий и машину, которую не жалко отдать агенту на изменение.
Работает ли это на Windows или только на macOS и Linux?Релиз проверен только на Mac с Apple Silicon и Linux (Ubuntu 24.04 LTS); на Mac с Intel ожидается, что заработает, но это не проверено, а Windows не поддерживается.
Безопасно ли давать этому трогать мой реальный код?README прямо предупреждает, что пока нет: агенты работают с неинтерактивным обходом разрешений под вашей учётной записью и без песочницы, поэтому рекомендуется репозиторий только для тестов.
Что на самом деле делает шаблон Full Assurance?Это цепочка из 12 шагов: написание спецификации, планирование, ревью плана, доработка, реализация, два «слепых» ревью кода, применение правок, документация, проверка на регрессии и финальный механический шаг проверки готовности к мержу и выполнения мержа.
Почему ревью кода именно два, отдельных?Правило дизайна Anneal: кто написал код, тот его никогда не оценивает — два ревью кода выполняются вслепую, не видя находок друг друга, а следующий шаг разбирает оба набора находок до применения правок.
Можно ли настроить роли агентов и шаги цепочки?Да, шаблон — это данные, а не код: роли, промпты, модели и гейты лежат в редактируемых файлах в agents/templates/, так что вы можете задать свои роли агентов и перестроить рабочий процесс.
Что происходит, когда цепочка не может продолжаться без меня?Она останавливается и ждёт: агент может задать вопрос через веб-инбокс, помеченный вами как гейт шаг приостанавливается до вашего решения, либо запуск эскалируется — и цепочка продолжается, как только вы ответите.
What are similar projects?orca, gastown, wicked-studio, oh-my-codex, cc-wf-studio, buzz, claude-code, oh-my-subagents
Which topics is it in?code-review, gpt, workflow-automation, agent-orchestration, git, docker-compose, multi-agent, local-first, claude, codex, agent, claude-code
Creator
mosonlab
Size
30.5 MB
Stars
187
Updated
CommitSep 26
Age
2mo
Commits · 90 Days