Command Reference

run app factory

Generates and ranks 10 app ideas for selective building.

Behavior

• • Executes Stage 01 ONLY and generates EXACTLY 10 ranked ideas
• • Creates idea directories with metadata (no stages 02-10)
• • Updates global leaderboard with ranked ideas
• • Leaves ideas in “idea bin” state for later building

Output Structure

runs/YYYY-MM-DD/<run_name>/
├── stage01/stages/stage01.json    # 10 validated ideas
├── ideas/
│   ├── 01_<slug>__<id>/meta/      # Idea bin - metadata only
│   ├── 02_<slug>__<id>/meta/
│   └── ... (10 directories)
└── meta/
    ├── idea_index.json
    └── run_manifest.json

build <IDEA>

Builds ONE selected idea from the idea bin into a complete Expo React Native app.

Behavior

• • Resolves idea target from slug or name alias
• • Executes missing stages 02-09 IN ORDER
• • Executes Stage 10 app building
• • Outputs complete Expo app to builds/<idea_dir>/

Example

dream <IDEA_TEXT>

Transforms a raw app idea into a complete, store-ready Expo React Native app via end-to-end pipeline execution.

Behavior

• • Parses raw idea and creates run directory
• • Executes Dream Stage 01 (single idea validation)
• • Executes Stages 02-10 automatically
• • Produces ONE store-ready app from raw idea text

validate run

Validates the most recent run or current run if active.

• • Confirms run_manifest.json exists and is valid
• • Confirms Stage JSON artifacts exist and validate against schemas
• • Confirms Stage 01 produced exactly 10 ideas
• • No generation - validation only

show status

Prints the current run status using run_manifest.json and per-idea stage_status.json files.

• • No generation, no mutation
• • Shows progress for all ideas in current run