@genex-ai/cli-demo 0.48.0 → 0.49.0-dev.92

package/README.md

@@ -6,6 +6,7 @@ This is the `cli` app of the [genex monorepo](../../README.md).
 ```bash
 genex init <name>          # authorize + create the draft project
 genex link <slug>          # re-link this folder to an existing game of yours (recovery)
+genex list                 # list your games — slug, status, page link (find the slug to link)
 genex preview              # build + push to the hosted draft URL (unlisted)
 genex publish              # build + push, then list the game in the gallery
 genex make-remixable          # make this game remixable — migrate a private source to a public repo
@@ -15,9 +16,11 @@ 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 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 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)
 ```
 
 > **Invoking it.** First-time setup runs via `npx @genex-ai/cli-demo@latest init`.

package/dist/index.js

@@ -8,7 +8,7 @@ import fs from "fs";
 import os from "os";
 import path from "path";
 import { fileURLToPath } from "url";
-var RAW_CHANNEL = "latest";
+var RAW_CHANNEL = "dev";
 var CLI_CHANNEL = RAW_CHANNEL === "dev" ? "dev" : "latest";
 var STANDS = {
   prod: { api: "https://api.genex.games", dashboard: "https://genex.games" },
@@ -1328,6 +1328,113 @@ async function listOwnSlugs(apiUrl, token, log) {
   }
 }
 
+// src/commands/list.ts
+async function runList(opts) {
+  const log = createLogger({ quiet: opts.quiet });
+  const extra = opts.name?.trim();
+  if (extra) {
+    log.error(
+      `\`genex list\` lists your games \u2014 \`genex list ${extra}\` isn't available yet.`
+    );
+    process.exitCode = 1;
+    return;
+  }
+  let token = opts.token ?? await readUserToken(opts.envPath);
+  if (!token) {
+    if (opts.noAuth) {
+      log.error("Not signed in. Re-run without --no-auth to connect in the browser.");
+      process.exitCode = 1;
+      return;
+    }
+    log.plain("Not signed in \u2014 opening the browser to connect\u2026");
+    try {
+      token = await authorize(getAuthUrl(opts.authUrl), {
+        log,
+        timeoutMs: opts.timeoutSec ? opts.timeoutSec * 1e3 : void 0
+      });
+    } catch (err) {
+      log.error(`Sign-in didn't complete: ${String(err)}`);
+      process.exitCode = 1;
+      return;
+    }
+    const { path: tokenPath } = await writeUserToken(token, opts.envPath);
+    log.success(`Authorized. Saved your token to ${c.cyan(tokenPath)}.`);
+    log.plain("");
+  }
+  const meta = await readProject();
+  const apiUrl = getApiUrl(opts.apiUrl ?? meta?.apiUrl);
+  const dashOrigin = (meta?.dashboardOrigins?.[0] ?? getAuthUrl(opts.authUrl)).replace(/\/+$/, "");
+  const projectsUrl = `${apiUrl}/api/projects`;
+  const fetchProjects = (t) => apiFetch(projectsUrl, { headers: { Authorization: `Bearer ${t}` } });
+  let res;
+  try {
+    res = await fetchProjects(token);
+    if (res.status === 401 && !opts.token && !opts.noAuth) {
+      log.plain("Your saved sign-in was rejected \u2014 reconnecting in the browser\u2026");
+      token = await authorize(getAuthUrl(opts.authUrl), {
+        log,
+        timeoutMs: opts.timeoutSec ? opts.timeoutSec * 1e3 : void 0
+      });
+      await writeUserToken(token, opts.envPath);
+      res = await fetchProjects(token);
+    }
+  } catch (err) {
+    log.error(`Couldn't reach the API at ${apiUrl}.`);
+    log.dim(`  ${String(err)}`);
+    process.exitCode = 1;
+    return;
+  }
+  if (!res.ok) {
+    if (!printedStructuredError(res)) {
+      if (res.status === 401) {
+        log.error("Not authorized \u2014 your sign-in was rejected. Re-run `genex list` to reconnect.");
+      } else {
+        log.error(`Couldn't list your games (HTTP ${res.status}).`);
+      }
+    }
+    process.exitCode = 1;
+    return;
+  }
+  const body = await res.json().catch(() => null);
+  const projects = body?.projects ?? [];
+  if (opts.json) {
+    console.log(JSON.stringify(projects, null, 2));
+    return;
+  }
+  const email = await fetchSignedInEmail(apiUrl, token);
+  if (email) log.plain(`  signed in as ${c.cyan(email)}`);
+  if (projects.length === 0) {
+    log.plain("You have no games yet \u2014 `npx genex init <name>` in a new folder creates one.");
+    return;
+  }
+  log.plain("");
+  for (const p of projects) {
+    const published = p.status === "published";
+    const pageUrl = `${dashOrigin}/${published ? "world" : "draft"}/${p.slug}`;
+    const isHere = Boolean(meta && (meta.id === p.id || meta.slug === p.slug));
+    const bits = [
+      published ? c.green("published") : c.dim("draft"),
+      published && p.playsCount ? `${p.playsCount} play${p.playsCount === 1 ? "" : "s"}` : "",
+      p.private ? "remixing off" : "",
+      p.purchaseUrl ? "paid" : "",
+      p.updatedAt ? `updated ${relTime(p.updatedAt)}` : ""
+    ].filter(Boolean).join(" \xB7 ");
+    log.plain(`  ${c.bold(p.slug)}  ${bits}${isHere ? c.green("  \u2190 this folder") : ""}`);
+    log.dim(`    ${pageUrl}`);
+  }
+  if (projects.length === 100) {
+    log.dim("  (showing your 100 most recent games)");
+  }
+}
+function relTime(iso) {
+  const ms = Date.parse(iso);
+  if (Number.isNaN(ms)) return "recently";
+  const s = Math.max(0, (Date.now() - ms) / 1e3);
+  if (s < 3600) return `${Math.max(1, Math.floor(s / 60))}m ago`;
+  if (s < 86400) return `${Math.floor(s / 3600)}h ago`;
+  return `${Math.floor(s / 86400)}d ago`;
+}
+
 // src/lib/deploy.ts
 import { spawn as spawn3 } from "child_process";
 import crypto3 from "crypto";
@@ -3810,6 +3917,9 @@ ${c.bold("Usage")}
   genex link <slug> [options]        Re-link THIS folder to an existing game of yours
                                      (lost folder / new machine); preview/publish then
                                      update the same live game. Never creates a project.
+  genex list [options]               List your games \u2014 slug, status, and page link for
+                                     each. Signs you in if needed; --json for raw data.
+                                     Find the slug to reconnect with 'genex link' here.
   genex preview [options]            Build + push to the hosted draft URL (unlisted).
   genex publish [options]            Build + push, then list the game in the gallery.
   genex make-remixable [options]     Make THIS game remixable by everyone \u2014 migrates a
@@ -3908,6 +4018,12 @@ ${c.bold("Options for `explore`")}
   --api-url <url>      Override the API base URL.
                        (No query at all lists the entire curated catalog.)
 
+${c.bold("Options for `list`")}
+  --json               Print your games as JSON (all fields, incl. play/clone URLs).
+  --api-url <url>      Override the API base URL.
+  --env <path>         Token env file (default: ~/.genex/env).
+  --auth-url <url>     Override the auth site (used only if sign-in is needed).
+
 ${UI_USAGE}
 
 ${c.bold("Global")}
@@ -3925,6 +4041,7 @@ ${c.bold("Environment")}
 ${c.bold("Examples")}
   genex init my-game
   genex init my-game --api-url http://localhost:3000 --auth-url http://localhost:5173
+  genex list
   genex link my-game
   genex preview
   genex publish
@@ -4280,6 +4397,9 @@ async function main() {
       case "link":
         await runLink(parsed.options);
         break;
+      case "list":
+        await runList(parsed.options);
+        break;
       case "make-remixable":
         await runMakeRemixable(parsed.options);
         break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/cli-demo",
-  "version": "0.48.0",
+  "version": "0.49.0-dev.92",
   "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-ai-hud/SKILL.md

@@ -391,7 +391,7 @@ after a bad single costs the whole chain).
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev init` first (it
   writes your `GENEX_TOKEN`).
 - **"Prompt rejected"** — the provider's content-safety filter blocked the
   prompt. Non-retryable; rewrite the wording.

package/templates/skills/genex-ai-image/SKILL.md

@@ -182,7 +182,7 @@ set belongs to `$genex-ai-hud` — both build on this command.
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev init` first (it writes your `GENEX_TOKEN`).
 - **"Prompt rejected"** — the provider's content-safety filter blocked the prompt.
   This is non-retryable; retrying the same wording fails again. Rewrite the prompt.
 - **Decal is an opaque rectangle** — the image has no alpha. Regenerate with

package/templates/skills/genex-ai-menu/SKILL.md

@@ -321,7 +321,7 @@ upgrades, in order of effort:
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev init` first (it
   writes your `GENEX_TOKEN`).
 - **"Prompt rejected"** — the provider's content-safety filter blocked the
   prompt. Non-retryable; rewrite the wording.

package/templates/skills/genex-ai-model/SKILL.md

@@ -107,7 +107,7 @@ scene is a ghost: players and objects pass straight through it.
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev init` first (it writes your `GENEX_TOKEN`).
 - **"Out of credits" (`insufficient_credits`)** — the account has no credits left for
   this model generation. Tell the user the facts the CLI printed: their balance, this
   generation's cost, and when their credits refill. Then offer to continue the build

package/templates/skills/genex-ai-sfx/SKILL.md

@@ -72,7 +72,7 @@ Reuse one loaded `buffer` across many plays; create a fresh `Audio`/`PositionalA
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev init` first (it writes your `GENEX_TOKEN`).
 - **"Out of credits" (`insufficient_credits`)** — the account has no credits left for
   this sound generation. Tell the user the facts the CLI printed: their balance, this
   generation's cost, and when their credits refill. Then offer to continue the build

package/templates/skills/genex-ai-skybox/SKILL.md

@@ -76,7 +76,7 @@ scene.background = texture; // keep the raw texture for the visible sky
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev init` first (it writes your `GENEX_TOKEN`).
 - **"Out of credits" (`insufficient_credits`)** — the account has no credits left for
   this skybox generation. Tell the user the facts the CLI printed: their balance, this
   generation's cost, and when their credits refill. Then offer to continue the build

package/templates/skills/genex-ai-texture/SKILL.md

@@ -81,7 +81,7 @@ scene.add(ground);
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev init` first (it writes your `GENEX_TOKEN`).
 - **"Out of credits" (`insufficient_credits`)** — the account has no credits left for
   this texture generation. Tell the user the facts the CLI printed: their balance,
   this generation's cost, and when their credits refill. Then offer to continue the

package/templates/skills/genex-ai-video/SKILL.md

@@ -145,7 +145,7 @@ set belongs to `$genex-ai-hud` — both build on `npx genex image`/`video`.
 
 ## Troubleshooting
 
-- **"Not authorized"** — run `npx @genex-ai/cli-demo@latest init` first (it writes your `GENEX_TOKEN`).
+- **"Not authorized"** — run `npx @genex-ai/cli-demo@dev init` first (it writes your `GENEX_TOKEN`).
 - **"Prompt rejected"** — the provider's content-safety filter blocked the prompt.
   This is non-retryable; retrying the same wording fails again. Rewrite the prompt.
 - **Nothing plays / black surface** — the first `video.play()` must run inside a user

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

@@ -43,7 +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>` — never use
+2. `cd <name>`, then `npx @genex-ai/cli-demo@dev 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`.

package/templates/skills/genex-getting-started/SKILL.md

@@ -125,9 +125,13 @@ and re-link the clone to the same live game:
 ```bash
 git clone <the game's repo url> my-game && cd my-game
 npm install
-npx @genex-ai/cli-demo@latest link <slug>   # slug = the name in the play URL
+npx @genex-ai/cli-demo@dev link <slug>   # slug = the name in the play URL
 ```
 
+Don't know the slug? **`npx genex list`** prints every game on your account —
+slug, status, and page link for each — signing you in first if needed. Find the
+game there, then `link` its slug.
+
 `link` never creates a project: it signs in if needed (the browser opens once)
 and rewrites the local link (source pushes authorize over HTTPS, so there's no
 key to set up — it works from any machine).
@@ -148,7 +152,7 @@ Safe to run any time — genex-owned skills are refreshed to the latest version,
 and your own files are never touched:
 
 ```bash
-npx @genex-ai/cli-demo@latest init
+npx @genex-ai/cli-demo@dev init
 ```
 
 Use `--force` only if you intentionally want your own existing files overwritten

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

@@ -38,7 +38,7 @@ update, so update immediately.)
 Run exactly the command the nudge printed, from the game project root:
 
 ```bash
-npm i -D @genex-ai/cli-demo@latest   # the genex CLI (a dev dependency)
+npm i -D @genex-ai/cli-demo@dev   # the genex CLI (a dev dependency)
 npm i @genex-ai/embed-sdk@latest     # identity/saves SDK (ships inside the game)
 npm i @genex-ai/multiplayer@latest   # multiplayer SDK (only if the game uses it)
 ```