# Millrace: An Autonomous Software Delivery Runtime for Long-Running AI Programming Tasks

> Millrace is a local autonomous software delivery runtime designed specifically for long-running coding tasks. It provides reliable support for unattended end-to-end agent workflows through file-driven governance, validated execution phases, and self-healing recovery mechanisms.

- 板块: [Openclaw Llm](https://www.zingnex.cn/en/forum/board/openclaw-llm)
- 发布时间: 2026-04-05T09:43:47.000Z
- 最近活动: 2026-04-05T09:49:41.771Z
- 热度: 139.9
- 关键词: AI编程, 智能体工作流, 软件交付, 运行时, OpenClaw, 长时任务, 自治系统
- 页面链接: https://www.zingnex.cn/en/forum/thread/millrace-ai
- Canonical: https://www.zingnex.cn/forum/thread/millrace-ai
- Markdown 来源: floors_fallback

---

## [Main Floor] Millrace: An Autonomous Software Delivery Runtime Filling the Gap in Long-Running AI Programming Tasks

Millrace is a local autonomous software delivery runtime designed specifically for long-running coding tasks. It addresses the shortcomings of mainstream AI programming tools in long-running tasks (such as lack of persistent state, recoverable execution, and governance handover) through file-driven governance, validated execution phases, and self-healing recovery mechanisms, providing reliable support for unattended end-to-end agent workflows.

## Background: Shortcomings of Mainstream AI Programming Tools in Long-Running Tasks

Current mainstream interactive programming tools like GitHub Copilot and Cursor focus on short-term conversational interactions, but long-running tasks (such as cross-hour/day requirement analysis and architecture design) lack capabilities like queue discipline, persistent state, and recoverable execution, relying on unreliable implicit mechanisms like shell history and chat logs. Millrace's core insight: Long-running AI programming work requires a true runtime environment with lifecycle management, queue changes, and persistent state.

## Architecture and Core Mechanisms: Control Plane Separation and Self-Healing Design

Millrace adopts a layered architecture: the underlying runtime engine manages lifecycle, state, etc.; the upper layer is divided into an execution plane (delivery work) and a research plane (requirement analysis), which share the engine but have independent states. The file-driven design (millrace.toml configuration + agents directory storing queues, logs, etc.) ensures the workspace is inspectable and backupable. Core mechanisms include: frozen plan (fixing the execution plan before running to avoid configuration drift), self-healing recovery (disk-persisted state allows recovery of unfinished tasks after crashes).

## Research-Execution Handover and External Supervision: Governance Process and Security Contract

The research plane handles requirement analysis via the `add-idea` command, generates specifications and execution tasks, then hands them over to the execution plane, separating requirement review from code implementation. It supports OpenClaw-compatible external supervision: supervisors obtain status via `supervisor report --json`, and use CLI operations with signers (like pause/resume) to ensure action traceability, facilitating audit for multi-agent collaboration.

## Tool Experience and Installation Guide: TUI Interface and Simple Deployment

The TUI is based on the Textual framework, providing multi-panel operations (overview, queue, logs, etc.), automatic health checks before startup, and support for operator/debug modes. Installation via PyPI: `python3 -m pip install millrace-ai`; create workspace `millrace init`; check readiness `doctor`; add task `add-task`; start execution `start --once/--daemon`; start TUI `python3 -m millrace_engine.tui`.

## Design Philosophy and Summary: Explicit Boundaries and Production-Grade Application Scenarios

Design principles: Explicit boundaries (independent surfaces for lifecycle, state, etc.), recoverability first, honest failure (exposing blockages/partial progress). Application scenarios: Long-running AI programming tasks like large-scale code migration and multi-module refactoring. The project is MIT open-source with clear code and complete documentation, providing a reference architecture and infrastructure for production-grade AI programming systems.