@genex-ai/cli-demo 0.22.0 → 0.23.0

package/dist/index.js

@@ -1870,11 +1870,6 @@ async function exists2(p) {
 async function runExplore(opts) {
   const log = createLogger({ quiet: opts.quiet });
   const query = opts.query?.trim();
-  if (!query) {
-    log.error('Missing query. Usage: genex explore "<what you need>"');
-    process.exitCode = 1;
-    return;
-  }
   const apiUrl = getApiUrl(opts.apiUrl);
   let res;
   try {
@@ -1890,17 +1885,21 @@ async function runExplore(opts) {
     return;
   }
   const { items } = await res.json();
-  const ranked = rank(items, query).slice(0, 5);
+  const ranked = query ? rank(items, query).slice(0, 5) : [...items].sort((a, b) => b.playsCount - a.playsCount);
   if (opts.json) {
     console.log(JSON.stringify(ranked, null, 2));
     return;
   }
   if (ranked.length === 0) {
     log.plain(
-      `No curated projects matched "${query}". Try a broader term (terrain, grass, vehicle, water, building, dungeon, fish, shader).`
+      query ? `No curated projects matched "${query}". Run \`genex explore\` with no arguments to browse the whole catalog, or try a broader term (terrain, grass, vehicle, water, building, dungeon, fish, shader).` : `The curated catalog is empty right now \u2014 check back soon.`
     );
     return;
   }
+  if (!query) {
+    log.plain(c.bold(`The full curated catalog (${ranked.length} project${ranked.length === 1 ? "" : "s"}):`));
+    log.plain("");
+  }
   for (const [i, p] of ranked.entries()) {
     const meta = [
       p.categories.join(", "),
@@ -1960,8 +1959,9 @@ ${c.bold("Usage")}
   genex texture "<prompt>" [options] Generate a PBR texture into public/assets/textures.
   genex controller <type> [--force]  Install a physics controller (character|car|drone)
                                      into src/controllers (+ assets into public/assets).
-  genex explore "<query>" [options]  Search the curated community gallery \u2014 proven
-                                     Three.js systems you can clone or borrow parts from.
+  genex explore ["<query>"] [options] Search the curated community gallery \u2014 proven
+                                     Three.js systems you can clone or borrow parts
+                                     from. No query lists the whole catalog.
 
 ${c.bold("Options for the generators (`model` `skybox` `sfx` `texture`)")}
   --terrain            (texture) seamless tiling surface for terrain/ground.
@@ -2008,8 +2008,9 @@ ${c.bold("Options for `preview` / `publish`")}
   --env <path>         Token env file (default: ~/.genex/env).
 
 ${c.bold("Options for `explore`")}
-  --json               Print the top matches as JSON (for tools/agents).
+  --json               Print the matches as JSON (for tools/agents).
   --api-url <url>      Override the API base URL.
+                       (No query at all lists the entire curated catalog.)
 
 ${c.bold("Global")}
   --quiet              Reduce output.
@@ -2036,6 +2037,7 @@ ${c.bold("Examples")}
   genex texture "mossy cracked cobblestone" --terrain
   genex controller character
   genex explore "grass"
+  genex explore
 `;
 function parseArgs(argv) {
   const parsed = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/cli-demo",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "Set up your ~/.claude workspace, authorize, create a game project, generate AI assets, and publish (genex CLI).",
   "type": "module",
   "bin": {

package/templates/skills/genex-explore/SKILL.md

@@ -23,6 +23,13 @@ Examples: `npx genex explore "grass"`, `npx genex explore "vehicle physics"`,
 `npx genex explore "procedural building"`. No sign-in needed — this works even
 before `genex init`.
 
+**Not sure what exists?** Run it with no arguments to browse the whole curated
+catalog first — it's small and every entry is proven:
+
+```bash
+npx genex explore
+```
+
 Each result prints everything you need to act on it:
 
 - `play:` — open it in the browser to judge whether it fits.
@@ -36,8 +43,7 @@ Add `--json` for machine-readable output.
 **As a NEW game (start from the whole project):**
 
 1. `git clone <clone URL from the output> <name>` — pick a short one-word name.
-2. `cd <name>`, then `npx @genex-ai/cli-demo@latest init <name>` — choose
-   "Ignore files and continue" if it warns the folder isn't empty; never use
+2. `cd <name>`, then `npx @genex-ai/cli-demo@latest init <name>` — never use
    `--force`. This creates your own project; the original is untouched.
 3. `npm install`, keep `base: './'` in `vite.config`, then build your changes
    and ship with `npx genex preview`.
@@ -64,6 +70,7 @@ build from one:
 - keep any in-game credits screens or notices in place;
 - carry the credit into anything you publish or remix from it.
 
-If nothing matches your query, try a broader term (terrain, grass, vehicle,
+If nothing matches your query, run `npx genex explore` with no arguments to
+see everything available, or try a broader term (terrain, grass, vehicle,
 water, building, dungeon, fish, shader) — or build it with the regular
 `genex-threejs-*` skills instead.