@dorely13/ai-imagegen-cli 0.3.0 → 0.4.0

package/dist/help.js

@@ -1,9 +1,13 @@
 const PROFILE_HELP = `Named endpoint profiles:
-  imagegen providers add <name> --api <openrouter|openai-images> [--base-url <url>]
-                         [--model <id>] [--auth <bearer|none>]
+  imagegen providers add <name> --api <openrouter|openai-images|comfyui>
+                         [--base-url <url>] [--model <id>] [--auth <bearer|none>]
+                         [--start-command <text>] [--workflow <file>]
+                         [--edit-workflow <file>]
   imagegen providers show <name>
   imagegen providers update <name> [--api <format>] [--base-url <url>]
                          [--model <id>] [--auth <bearer|none>]
+                         [--start-command <text>] [--workflow <file>]
+                         [--edit-workflow <file>]
   imagegen providers remove <name>
   imagegen auth <name> login [--key-stdin]
   imagegen auth <name> status [--show-path]
@@ -11,8 +15,9 @@ const PROFILE_HELP = `Named endpoint profiles:
   imagegen models --provider <name>
 
 OpenRouter defaults to https://openrouter.ai/api/v1. openai-images requires
---base-url including the API prefix (e.g. https://api.openai.com/v1).
-Keys use hidden terminal input or explicit --key-stdin and the existing vault/file
+--base-url including the API prefix (e.g. https://api.openai.com/v1). comfyui
+requires --base-url of its server (e.g. http://127.0.0.1:8188) and --model, and
+uses no key. Keys use hidden terminal input or explicit --key-stdin and the existing vault/file
 store. --auth none supports endpoints without keys. Config is saved in providers.json
 alongside the credential file. Origin changes clear the saved key; removing a
 profile removes its credentials. Logout preserves profile configuration.
@@ -21,13 +26,25 @@ Select named profiles with --provider. Model precedence: --model > profile defau
 provide one if no default is saved. models explicitly discovers model metadata;
 OpenAI-compatible model listings do not establish image capabilities.
 
-Supported protocols: OpenRouter dedicated Images API and OpenAI Images JSON /
-multipart endpoints, not arbitrary HTTP templates. Options vary by model.
+Supported protocols: OpenRouter dedicated Images API, OpenAI Images JSON /
+multipart endpoints, and local models through ComfyUI, not arbitrary HTTP
+templates. Options vary by model.
 OpenRouter accepts aspect ratios; openai-images needs pixels or presets:
 square 1024x1024, portrait 1024x1536, landscape 1536x1024, wide 1536x864.
 Auto options are omitted. Native masks require openai-images.
 Outputs are measured and converted to PNG/JPEG/WebP without resizing. Count uses
 separate single-image requests without automatic retries or model substitution.
+
+comfyui profiles: --model names what the profile renders. Built in: flux3-klein
+expands the prompt and reports the rendered caption as prompt; flux3-klein-raw
+uses the prompt as the full caption; quality low, medium, and high run 4, 8, and
+16 steps. Any other model needs --workflow (text-to-image) and/or --edit-workflow
+(input images): ComfyUI API-format JSON using {{prompt}} and {{seed}}, optionally
+{{width}} and {{height}}, and {{image1}}, {{image2}}, ... for inputs. Workflow
+files set their own sampling, so only --quality auto applies.
+Sizes accept pixels, presets, or aspect ratios, round to multiples of 16, and need
+edges from 256 to 2048. Masks are rejected. The CLI does not start or stop ComfyUI;
+--start-command records how to start it and is quoted when it is not reachable.
 `;
 const IMAGE_OPTIONS = `Image options (generate, edit):
   --prompt <text>        Prompt text (required)
@@ -55,34 +72,41 @@ Gemini provider:
   Model precedence: --model > constructor imageModel > IMAGEGEN_GEMINI_IMAGE_MODEL
   > gemini-nano-banana-2.1. Calls are independent; use prior output as --source.
 
-Supported Codex models (account availability is determined by the provider):
-  gpt-image-2.5-flare     Default; fast image generation and editing
-  gpt-image-2.5-sunburst  Higher-precision image generation and editing
-  gpt-image-2            Previous model; retained for compatibility
+Codex model requests (the backend chooses what actually runs):
+  gpt-image-2.6-flare     Requested by default
+  gpt-image-2.6-sunburst  Requested with --model
+  gpt-image-2.5-flare     Requested with --model
+  gpt-image-2.5-sunburst  Requested with --model
+  gpt-image-2            Requested with --model
 
-Use full model IDs; other provider-supported IDs may also be supplied.
+Codex accepts any model ID, including made-up ones, and does not report what ran;
+its Responses route rewrites these requests to gpt-image-2-codex. Use a named
+profile such as OpenRouter when a specific model matters.
 Model precedence: --model > constructor imageModel (library callers) >
-IMAGEGEN_CODEX_IMAGE_MODEL > gpt-image-2.5-flare.
-Codex may override the requested model, quality, and size; results report the
-returned dimensions. Codex ignores --mask; describe the region in the prompt.
+IMAGEGEN_CODEX_IMAGE_MODEL > gpt-image-2.6-flare.
+JSON results report requestedModel, and servedModel per image (null unless the
+provider names one). Codex also reports served quality, size, and background, and
+may override what was requested. A Codex --mask is sent as the last edit image with a fixed
+instruction appended to the prompt; it steers the edit but does not guarantee
+untouched pixels outside it. It must match the source size, and uses one of the
+four edit-image slots.
 IMAGEGEN_USAGE_LOG=<file> appends one prompt-free JSON usage line per result.
 
-Codex quality: auto (default), low, medium, high; Flare/Sunburst also support
-xhigh and max. gpt-image-2 rejects xhigh/max.
+Codex quality requests: auto (default), low, medium, high; Flare/Sunburst IDs also
+accept xhigh and max. gpt-image-2 rejects xhigh/max. The backend may serve another.
 `;
 const GENERATE_EXAMPLES = `Examples:
   imagegen generate --provider gemini --size 16:9 --prompt "a lighthouse at dawn" --out ./gemini.png
   imagegen generate --prompt "a lighthouse at dawn" --out ./lighthouse.png
-  imagegen generate --model gpt-image-2 --prompt "a lighthouse" --out ./classic.png
-  imagegen generate --model gpt-image-2.5-sunburst --quality max --prompt "a product photo" --out ./product.png
+  imagegen generate --provider openrouter --model openai/gpt-image-2.6-sunburst --quality high --prompt "a product photo" --out ./product.png
 `;
 const EDIT_EXAMPLES = `Edit options:
   --source <file>        Source image (required)
-  --mask <file>          Optional edit mask (openai-images; Codex ignores it)
+  --mask <file>          Optional edit mask; transparent pixels mark the area to edit
 
 Examples:
   imagegen edit --format webp --source ./product.png --prompt "make the product blue" --out ./blue.webp
-  imagegen edit --model gpt-image-2.5-sunburst --quality max --source ./product.png --prompt "add a ribbon" --out ./ribbon.png
+  imagegen edit --provider openrouter --model openai/gpt-image-2.6-sunburst --source ./product.png --prompt "add a ribbon" --out ./ribbon.png
 `;
 export const USAGE = `imagegen - provider-agnostic image generation CLI
 
@@ -100,6 +124,7 @@ Usage:
   imagegen skill
   imagegen skill install --target <claude|codex|skills-dir> [--target <...>] [--force]
   imagegen help [command]
+  imagegen --version
 
 ${PROFILE_HELP}
 ${IMAGE_OPTIONS}
@@ -115,6 +140,7 @@ Auth options:
 
 Global:
   -h, --help             Show help and exit 0
+  --version              Print the CLI version and exit 0
 `;
 const COMMAND_HELP = {
     auth: `imagegen auth - manage provider credentials (one namespace per provider)