@genex-ai/cli-demo 0.47.0-dev.71 → 0.47.0

package/README.md

@@ -17,6 +17,7 @@ genex image "<prompt>"     # generate an image    → prints an asset URL
 genex video "<prompt>"     # generate a video     → prints an asset URL
 genex controller <type>    # character|car|drone|networked-physics → src/controllers/
 genex controller anims <sel…>  # download extra character animation clips (by tag or name) → public/assets/anims/
+genex ui <tool>            # local pixel toolbox for generated UI art: extract | masks | text-color | trim
 ```
 
 > **Invoking it.** First-time setup runs via `npx @genex-ai/cli-demo@latest init`.
@@ -92,6 +93,25 @@ downloaded or committed:
 | `genex image "<prompt>" [--transparent] [--aspect <ratio>]` | fal.ai | `…/generations/<id>/image-main` |
 | `genex video "<prompt>" [--duration <s>] [--loop]` | fal.ai | `…/generations/<id>/video-mp4` |
 
+`genex image` and `genex video` also power the game-UI pipeline (menus + HUD
+sprite sets — see the `genex-ai-menu` / `genex-ai-hud` skills):
+
+- **image** — `--quality <low|medium|high>` (provider quality preset),
+  `--size <WxH>` (exact pixel size, e.g. `2560x1440`), `--edit <url>` (edit an
+  existing generated image with the prompt), `--clean <url>` (ML background
+  removal only; defaults `--bg-mode sheet`), `--remove-bg` (chain background
+  removal after the gen/edit), `--bg-mode <sprite|glyph|sheet>` (removal model).
+  Image inputs must be generated-asset URLs (`assets.genex.technology`) — the
+  API rejects other hosts.
+- **video** — `--frame <url>` (animate from a frame back to itself: a
+  mathematically seamless loop) or `--first-frame <url>` + `--last-frame <url>`
+  (two-frame motion).
+- **`genex ui <extract|masks|text-color|trim>`** — the local, no-API pixel
+  toolbox that finishes the job: split an asset sheet into per-element
+  transparent PNGs (+ `.bbox.json` sidecars), key green-annotated fill masks,
+  eyedrop text colors, and trim sprites to their alpha bbox. Every tool reads
+  `--in <local png or https URL>`. Run `genex --help` for per-tool flags.
+
 Each URL is a permanent `https://assets.genex.technology/...` address served straight
 from R2 (with CORS, so three.js loads it cross-origin without tainting). It resolves
 the same in local dev, the published game, and remixes, and the bytes never pass back
@@ -102,8 +122,11 @@ Auth reuses the existing `GENEX_TOKEN` (run `genex init` first). Server-side, ea
 provider is keyed by an env var (`TRIPO_API_KEY`, `BLOCKADE_LABS_API_KEY`,
 `ELEVENLABS_API_KEY`, `GEMINI_API_KEY`, and `FAL_KEY` for image + video); when a key
 is unset that kind falls back to a built-in **mock** provider that returns sample
-assets, so the flow runs keyless. `--no-wait` enqueues without downloading — useful
-for video, which is minutes-class end-to-end.
+assets, so the flow runs keyless. `--no-wait` enqueues and prints the generation id;
+`genex wait <id>` attaches to it later and prints the asset URL(s) when it finishes —
+safe to re-run, it never creates a new generation (re-running the *generate* command
+does, and bills it). `genex image --candidates <2-4>` returns several variants from
+one call (`image-main` + `image-alt-N` URLs) — pick the best instead of re-rolling.
 
 ## Install / run