Needs the Codex CLI installed and signed in: check codex --version and codex login status. If either fails, read references/setup-codex.md and guide the user through it before going on.

Install the bundled CLI at the target repo root (scripts/image_gen is in this skill's folder). If .codex/scripts/image_gen already exists, inspect it before replacing.

mkdir -p .codex/scripts
cp <this-skill-folder>/scripts/image_gen .codex/scripts/image_gen
chmod +x .codex/scripts/image_gen

Default output: .codex/scripts/output/<batch-name>-<timestamp>/ with NNN-clean-name.png, logs/job-NNN.log, and manifest.json (copied[]: path, promptIndex, prompt, name). Prefer { "name", "prompt" } objects for stable names.

.codex/scripts/image_gen --name hats --prompts '["prompt one", "prompt two"]'
.codex/scripts/image_gen --out .codex/scripts/output/tshirts --prompts '[{"name":"men-white-crew-tee","prompt":"..."}]'
.codex/scripts/image_gen --name catalog --prompts prompts.json --concurrency 3
.codex/scripts/image_gen --name cap-variants --prompt "..." --count 3
.codex/scripts/image_gen --prompts prompts.json --dry-run

codex-images