mini do

Runs Claude Code on the current phase or step and writes a report.

Usage

mini do [options]

  --stream             Run Claude in print mode with streamed JSON output
  --max-turns <n>      Stop the session after N Claude responses (saves tokens)
  --apply              Mark the phase in progress, create .mini/run/ (for /mini:do)
  --step-done <title>  With --apply: mark one step of the phase as done

Description

The terminal command. Drives the implementation of the current phase: it hands Claude Code the phase goal and its planned steps, lets it edit the code, and expects a run report in .mini/run/. Use --stream to watch the work live and --max-turns to cap the session length. The --apply / --step-done flags are the non-interactive plumbing used to flip state and track per-step progress.

Examples

# Implement the current phase interactively
mini do

# Watch progress live and cap the session length
mini do --stream --max-turns 40

# Plumbing used to track a finished step
mini do --apply --step-done "Add the login form"