millstone¶
millstone is a Python CLI that orchestrates agentic coding tools in a deterministic builder-reviewer loop.
What it does¶
- Runs tasks from a tasklist through build, sanity checks, and review.
- Supports autonomous outer loops (
analyze,design,plan,cycle). - Captures run logs and evaluation artifacts under
.millstone/.
Install¶
pipx install millstone
Quick start¶
millstone --help
millstone
millstone --task "add input validation"
Operator Prompts¶
Paste one of these as a system prompt to let an AI agent drive millstone for you:
- execute.md — run a tasklist to completion
- design.md — turn an idea into a reviewed design + plan
→ Which prompt to use and how to invoke them
Learn more¶
- Getting Started
- Parallel Execution (Worktrees)
- CLI Providers — Claude Code, Codex, Gemini, OpenCode
- Artifact Providers — GitHub, Jira, Linear, Confluence, Notion, MCP
- Loop Ontology
- Scope and Boundaries
- Contributing
- Maintainers