Frequently asked questions
Short answers to the questions newcomers ask most.
What is mini-orchestrator?
A small CLI that drives a project one verifiable phase at a time, directly inside your Claude Code session. mini holds the project state and prints the right prompt; Claude does the actual work. The Get started page walks through it end to end.
How do I install it?
Install it globally from npm: npm install -g mini-orchestrator@latest. You need Node.js 20 or newer and a working Claude Code setup. A global install wires the /mini:* slash commands into Claude Code automatically.
How do I choose the Claude model?
Run mini model to see the current model, or mini model <name> to set it for the project. mini stores the choice in the project state, so every phase uses the same model until you change it.
What is the phase loop?
Each phase goes through next (propose) → plan (break into steps) → do (implement) → done (you confirm it works). Two optional steps fit in: discuss before planning, and verify for a human UI/UX review.
What does auto mode do?
mini auto chains next → plan → do → done in a row, so you finish whole phases without running each step by hand. It still stops at the human checkpoints — proposing the next phase, the verify review and the final "does it work?". Use --max-phases to run several phases in one go.
Still stuck?
Every command has its own page in the manual, with both the terminal and the /mini:* slash form. The source and issue tracker live on GitHub.