#mini-orchestrator
English

Get started

From installing the mini CLI to running your first phase, in a few commands.

Before you start

You need Node.js 20 or newer and a working Claude Code setup. mini sits on top of Claude Code: it holds your project state and prints the right prompt, while Claude does the work inside your session.

Install

Install the CLI globally from npm. The command is called mini:

npm install -g mini-orchestrator@latest

A global install wires the /mini:* slash commands into Claude Code automatically. To update, run the same command again. In a local or CI install run mini install-commands once by hand.

Your first project

Create a project folder and let mini drive it one phase at a time. Run these inside the folder:

mkdir my-project && cd my-project

mini init        # 4 questions → creates .mini/project.md and .mini/state.json
mini next        # Claude proposes the first phase
mini do          # starts a Claude Code session on the phase
mini done        # "does it work?" → moves the state forward
  1. mini init Answer 4 questions; mini writes the project state into .mini/.
  2. mini next Claude proposes one small, verifiable phase.
  3. mini discuss Optional. Talk a tricky phase through before planning it.
  4. mini do A Claude Code session implements the phase.
  5. mini done You confirm it works and the state moves forward.

Inside Claude Code: slash commands

Every step also has a native /mini:* slash form you run inside a Claude Code session — mini prints the prompt, Claude does the work and saves the state back. The optional steps (discuss, verify) are dashed. Click any command for its docs:

  1. /mini:init Answer 4 questions; mini writes the project state into .mini/.
  2. /mini:next Claude proposes one small, verifiable phase.
  3. /mini:discuss Optional. Talk a tricky phase through before planning it.
  4. /mini:plan Break the phase into concrete, checkable steps.
  5. /mini:do A Claude Code session implements the phase.
  6. /mini:verify Optional. An in-depth UI/UX review by a human.
  7. /mini:done You confirm it works and the state moves forward.

Both forms do the same thing — pick the terminal command or the slash form depending on where you are. Each command has its own page in the manual covering both forms.

The auto shortcut

Want it hands-off? mini auto chains next → plan → do → done in a row, asking only the final "does it work?". It has a slash form too — /mini:auto — for running the loop inside a Claude Code session:

  1. mini auto Run the whole loop from your terminal.
  2. /mini:auto Run the loop inside a Claude Code session.

Where to next

Every command has its own page in the manual, in both the terminal form and the /mini:* slash form.

Browse the command manual View on GitHub