@genex-ai/cli-demo 0.48.0-dev.91 → 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

@@ -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-dev.91",
+  "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-getting-started/SKILL.md

@@ -128,6 +128,10 @@ npm install
 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).