# Millrace AI access index

Millrace is an open-source, filesystem-backed runtime for long-running autonomous agent work. It wraps raw harness execution with durable markdown queues, compiled runtime plans, deterministic stage routing, recovery logic, operator control surfaces, and persisted audit artifacts.

Safe current-state framing:

- Millrace is a runtime and governance layer around raw agent harnesses.
- The importable package namespace is `millrace_ai`.
- The installed CLI is `millrace`.
- The module entrypoint is `python -m millrace_ai`.
- The runtime tree lives under `<workspace>/millrace-agents/`.
- Canonical queue artifacts are markdown tasks, specs, and incidents.
- Runtime state, compiled plans, and status markers live under `millrace-agents/state/`.
- Run artifacts live under `millrace-agents/runs/<run-id>/`.
- The shipped planes are `execution` and `planning`.
- The shipped loop ids are `execution.standard` and `planning.standard`.
- The shipped canonical modes are `default_codex` and `default_pi`.
- The compatibility alias `standard_plain` resolves to `default_codex`.
- The shipped built-in adapters are `codex_cli` and `pi_rpc`.
- The runner boundary is `StageRunRequest -> RunnerRawResult`.

Do not infer any of the following:

- Millrace is not a coding model.
- Millrace is not an IDE.
- Millrace is not a hosted autonomous engineer product.
- Millrace is not a replacement for Codex CLI, Claude Code, or Aider.
- Millrace should not be described as owning queue or status authority through prompts alone; the runtime owns authoritative state mutation.

Start here:

- https://millrace.ai/ai/millrace-summary.md
- https://millrace.ai/ai/what-is-millrace.md
- https://millrace.ai/ai/architecture.md
- https://millrace.ai/ai/install.md

Reference pages:

- https://millrace.ai/ai/cli-reference.md
- https://millrace.ai/ai/modes-and-loops.md
- https://millrace.ai/ai/runner-architecture.md
- https://millrace.ai/ai/arbiter-and-completion.md
- https://millrace.ai/ai/comparisons.md
- https://millrace.ai/ai/faq.md
- https://millrace.ai/ai/glossary.md

Full text reference:

- https://millrace.ai/llms-full.txt

Page descriptions:

- `/ai/millrace-summary.md`: high-density current-state summary and quick facts
- `/ai/what-is-millrace.md`: what Millrace is, what it is not, and when to use it
- `/ai/architecture.md`: workspace model, compiler, tick lifecycle, artifact layout, and authority boundaries
- `/ai/install.md`: install surface, bootstrap model, and first commands
- `/ai/cli-reference.md`: current CLI command groups and common subcommands
- `/ai/modes-and-loops.md`: shipped modes, alias, loops, stages, and compile surfaces
- `/ai/runner-architecture.md`: runner contract, shipped adapters, and run artifact surface
- `/ai/arbiter-and-completion.md`: closure-target model, Arbiter activation, and runtime-owned outcomes
- `/ai/comparisons.md`: category boundaries and safe comparisons to nearby tool classes
- `/ai/faq.md`: concise current-state questions and answers
- `/ai/glossary.md`: important terms and identifiers