@genex-ai/cli-demo 0.53.0-dev.121 → 0.54.0-dev.123

package/README.md

@@ -16,8 +16,12 @@ genex sfx "<prompt>"       # generate a sound fx  → prints an asset URL
 genex texture "<prompt>"   # generate a texture   → prints an asset URL
 genex image "<prompt>"     # generate an image    → prints an asset URL
 genex video "<prompt>"     # generate a video     → prints an asset URL
+genex character "<prompt>" # generate a controller-ready Meshy humanoid
+genex character animate <id> --action <action-id>  # add a same-rig Meshy action
+genex animations search "<intent>" --json           # search the committed Meshy catalog locally
 genex wait <id>            # attach to a --no-wait generation and print its URL(s) when done
 genex controller <type>    # character|car|drone|networked-physics → src/controllers/
+genex controller character --character <id>  # install the Meshy-native adapter + manifest
 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
 genex explore ["<query>"]  # search the curated community gallery (no query lists the whole catalog)
@@ -123,7 +127,8 @@ Three.js loader code.
 
 Auth reuses the existing `GENEX_TOKEN` (run `genex init` first). Server-side, each
 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
+`ELEVENLABS_API_KEY`, `GEMINI_API_KEY`, `MESHY_API_KEY` for characters, 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 and prints the generation id;
 `genex wait <id>` attaches to it later and prints the asset URL(s) when it finishes —
@@ -131,6 +136,32 @@ safe to re-run, it never creates a new generation (re-running the *generate* com
 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.
 
+## Meshy characters and animations
+
+`genex character "<prompt>"` runs a controller-ready Meshy workflow through the
+same authenticated credit, BullMQ/Redis, and R2 generation pipeline. It defaults
+to a Meshy 6 textured A-pose humanoid with browser-oriented remeshing, rigging, and the
+validated idle/walk/run/jump pack. `--animation <id-or-query>` is repeatable;
+`--height`, `--polycount`, `--no-controller-pack`, and `--no-wait` adjust the
+request. The CLI prints an atomic component quote before enqueueing.
+
+Search before spending:
+
+```bash
+genex animations search "rifle reload" --json
+genex character animate <character-id> --action <action-id>
+genex controller character --character <character-id>
+```
+
+Search is deterministic and local. Results include numeric action IDs, stable
+keys, previews, motion policy, controller suitability, requirements, review
+status, and estimated cost. Ambiguous text queries return ranked candidates;
+already-installed actions are not charged again. The controller command writes
+`public/assets/meshy-character.json`, whose permanent R2 URLs point at the
+current rigged model and compact same-signature animation GLBs. Re-run it after
+adding actions to refresh the manifest without overwriting existing controller
+source. The default `genex controller character` behavior remains VRM + UAL.
+
 ## Install / run
 
 From the monorepo root (the CLI runs directly via Node — no build step):