Mill turns one approved software change into a tested, reviewed Git commit. It gives a maintainer a way to show which requirement each check covers, which revision it ran against, and which action still needs approval.
Mill runs locally. It gives the coding agent a disposable worktree, runs the repository's native checks in an offline OCI verifier, and independently reviews the committed diff. You can accept a build-only result locally or separately authorize delivery to GitHub.
A patch is one step in delivery. The hard part is deciding what counts as done and keeping that decision intact through testing, fixes, review and interruptions. Mill freezes the task, its allowed paths and its acceptance checks before model work. A passing result names the exact candidate commit. If a remote action may already have happened, Mill reads back its outcome before another attempt.
Mill is useful when you own a Git repository, can name an independent check for the change, and want to keep approval and recovery decisions with a human maintainer.
Use Git and the Node version in .node-version. The public preview builds from source.
git clone https://github.com/davidahma/mill.git
cd mill
npm ci --ignore-scripts
npm run build
node dist/cli.js --versionTry the bundled preparation example in a temporary Git repository. It returns drafts and questions without writing authority files, calling a model, or running the example's tests.
example_dir=$(mktemp -d)
cp examples/preparation/PRD.md examples/preparation/request.yaml "$example_dir/"
git -C "$example_dir" init --quiet
node dist/cli.js --json --cwd "$example_dir" init prepare \
--prd PRD.md --request request.yamlThe result includes data.executionReady: false. The example deliberately
leaves acceptance ownership unresolved. The planning guide
shows how to resolve the questions and prepare an approved task for a real
repository.
- Approve one outcome. Select the acceptance checks, allowed paths and budget. Run native baseline qualification and review its approval digest.
- Build one candidate. Admit the task with that digest. The worker's changes stay in a disposable worktree and Mill records the committed candidate.
- Verify and review. Run the frozen checks against the exact commit. Optionally import signed results from an independent runner before review.
- Choose the handoff. Record an attended local completion for build-only work, or plan and approve the exact draft PR in a delivery-enabled repository. Any attended merge has its own approval and resulting-main checks.
The operator guide has the commands, prerequisites and
recovery paths. The millctl start wrapper can coordinate one ready outcome.
| Workflow | Evidence and scope |
|---|---|
| Planning an existing repository | Read-only discovery, preparation, task compilation and readiness diagnostics |
| Node and TypeScript | Bundled Next.js recipe and bounded adoption. The pnpm workspace canary exercises one pinned layout. |
| Python CLI or library | Experimental build-only profile. Its real CPU fixture runs tests, builds a wheel and installs it offline. |
| External verification | Experimental signed receipt import for candidate-bound claims. The operator runs or delegates the job separately. |
| GitHub delivery | Optional attended draft PRs, exact-head check observation and provider readback. Requires your repository's delivery policy. |
The built-in Codex worker runs on a trusted host. Use it with source and host access you are comfortable exposing to the worker. The offline verifier bounds native command execution and the shipper has separate authority. See the security model and support scope for the assessed boundaries, including the status of hardware and isolation qualification.
npm run check
npm audit --omit=dev --audit-level=highThe development guide explains what each gate proves. The documentation index links to architecture, schemas, examples and evidence. The launch plan records the scope and acceptance checks. See Contributing to propose a change and Security to report a vulnerability.