mini import-gsd

Usage

mini import-gsd [options]

  (no option)   Read .planning/, show a preview and ask before writing
  --prompt      Print the extraction instructions and response schema, then stop
  --apply       Read a response from stdin and save the project (no Claude)
  --force       Overwrite an existing mini project (with --apply)

Description

The terminal command. A one-off setup step you run instead of `mini init` when the project already exists as a GSD plan under .planning/. It reads that plan and turns it into a mini project under .mini/ — the project name, description, target audience and constraints, plus the phase list with each phase's status preserved (done, doing, proposed, skipped). Run on its own it shows a preview and asks before writing; --prompt prints the extraction instructions and response schema without invoking Claude; --apply parses a response from stdin and saves the project, and --force lets it overwrite an existing mini project. Importing overwrites any existing mini project (the previous phase history is lost), though the model configuration is kept. Never edit .mini/state.json or .mini/project.md by hand — let the --apply form write them.

Examples

# Interactive: preview the GSD plan and confirm the import
mini import-gsd

# Print the extraction instructions and response schema
mini import-gsd --prompt

# Overwrite an existing mini project from a saved response
mini import-gsd --apply --force < response.json