@genex-ai/cli-demo 0.3.0 → 0.4.0

package/README.md

@@ -21,9 +21,13 @@ genex texture "<prompt>"   # generate a texture   → assets/textures/
 
 `genex init` does four things:
 
-1. **Scaffolds your workspace** — copies the bundled templates (skills, agents,
-   commands) into `~/.claude`, *merging* into whatever is already there. Existing
-   files are **never overwritten**.
+1. **Installs the skills for your coding agents** — copies the bundled templates
+   into every agent it detects: Claude Code (`~/.claude`, full set incl.
+   agents/ + commands/), Codex (`~/.codex/skills`), and Cursor
+   (`~/.cursor/skills`). genex-owned skills (`genex-*`) are **always refreshed**
+   to the package version so a stale copy can't linger; your own files are never
+   overwritten. Pick agents explicitly with `--agents claude,codex,cursor`, or a
+   single custom dir with `--dir`.
 2. **Authorizes you** — opens the Genex auth site (web) in your browser. If the
    browser can't open, it prints the URL to open manually.
 3. **Saves your token** — writes `GENEX_TOKEN` to `~/.genex/env` (per-user;
@@ -107,7 +111,8 @@ npx @genex-ai/cli-demo@latest init
 genex init [options]
 
 Options
-  --dir <path>         Destination workspace (default: ~/.claude)
+  --agents <list>      Agents to install for: claude,codex,cursor (default: auto-detect)
+  --dir <path>         Single destination workspace (overrides --agents)
   --env <path>         Token env file (default: ~/.genex/env)
   --auth-url <url>     Override the auth site (default: https://demo-web.glotech.world)
   --no-auth            Only scaffold templates; skip authorization

package/dist/index.js

@@ -9,6 +9,7 @@ import { fileURLToPath as fileURLToPath2 } from "url";
 import path6 from "path";
 
 // src/config.ts
+import fs from "fs";
 import os from "os";
 import path from "path";
 import { fileURLToPath } from "url";
@@ -42,45 +43,77 @@ function getTemplatesDir() {
   const here = path.dirname(fileURLToPath(import.meta.url));
   return path.resolve(here, "..", "templates");
 }
-function getClaudeDir(override) {
-  if (override) return path.resolve(override);
-  return path.join(os.homedir(), ".claude");
+var KNOWN_AGENTS = {
+  claude: { label: "Claude Code", dirName: ".claude", full: true },
+  codex: { label: "Codex", dirName: ".codex", full: false },
+  cursor: { label: "Cursor", dirName: ".cursor", full: false }
+};
+var KNOWN_AGENT_IDS = Object.keys(KNOWN_AGENTS);
+function resolveAgentTargets(opts = {}) {
+  if (opts.dir) {
+    return [{ id: "custom", label: "workspace", baseDir: path.resolve(opts.dir), full: true }];
+  }
+  const home = os.homedir();
+  let ids;
+  if (opts.agents && opts.agents.length > 0) {
+    ids = opts.agents.filter((id) => KNOWN_AGENTS[id]);
+  } else {
+    ids = KNOWN_AGENT_IDS.filter((id) => isDir(path.join(home, KNOWN_AGENTS[id].dirName)));
+    if (ids.length === 0) ids = ["claude"];
+  }
+  return ids.map((id) => {
+    const def = KNOWN_AGENTS[id];
+    return { id, label: def.label, baseDir: path.join(home, def.dirName), full: def.full };
+  });
+}
+function isDir(p) {
+  try {
+    return fs.statSync(p).isDirectory();
+  } catch {
+    return false;
+  }
 }
 
 // src/lib/copy-templates.ts
-import fs from "fs/promises";
+import fs2 from "fs/promises";
 import path2 from "path";
+function isGenexManaged(rel) {
+  return rel.split(path2.sep).some((seg) => seg.startsWith("genex"));
+}
 async function copyTemplates(srcDir, destDir, opts = {}) {
-  const result = { copied: [], skipped: [] };
+  const result = { copied: [], updated: [], skipped: [] };
   await walk(srcDir, srcDir, destDir, opts, result);
   return result;
 }
 async function walk(rootSrc, src, dest, opts, result) {
-  const entries = await fs.readdir(src, { withFileTypes: true });
+  const entries = await fs2.readdir(src, { withFileTypes: true });
   for (const entry of entries) {
     const srcPath = path2.join(src, entry.name);
     const destPath = path2.join(dest, entry.name);
     const rel = path2.relative(rootSrc, srcPath);
     if (entry.isDirectory()) {
-      await fs.mkdir(destPath, { recursive: true });
+      await fs2.mkdir(destPath, { recursive: true });
       await walk(rootSrc, srcPath, destPath, opts, result);
       continue;
     }
     if (!entry.isFile()) {
       continue;
     }
-    if (!opts.force && await exists(destPath)) {
+    const present = await exists(destPath);
+    const mayOverwrite = opts.force || isGenexManaged(rel);
+    if (present && !mayOverwrite) {
       result.skipped.push(rel);
       continue;
     }
-    await fs.mkdir(path2.dirname(destPath), { recursive: true });
-    await fs.copyFile(srcPath, destPath);
+    await fs2.mkdir(path2.dirname(destPath), { recursive: true });
+    await fs2.copyFile(srcPath, destPath);
     result.copied.push(rel);
+    if (present) result.updated.push(rel);
   }
 }
 async function exists(p) {
   try {
-    await fs.access(p);
+    await fs2.access(p);
     return true;
   } catch {
     return false;
@@ -416,7 +449,7 @@ function randomSuffix() {
 }
 
 // src/lib/ssh.ts
-import fs2 from "fs/promises";
+import fs3 from "fs/promises";
 import path3 from "path";
 import { spawn as spawn2 } from "child_process";
 var KEY_NAME = "genex_key";
@@ -424,7 +457,7 @@ async function generateSshKeypair(dir, log) {
   const keyPath = path3.join(dir, KEY_NAME);
   const pubPath = `${keyPath}.pub`;
   try {
-    const existing = (await fs2.readFile(pubPath, "utf8")).trim();
+    const existing = (await fs3.readFile(pubPath, "utf8")).trim();
     if (existing) {
       log.dim(`Reusing existing deploy key (${KEY_NAME}).`);
       return { publicKey: existing };
@@ -435,12 +468,12 @@ async function generateSshKeypair(dir, log) {
   const ok = await runSshKeygen(keyPath, log);
   if (!ok) return null;
   try {
-    const pub = (await fs2.readFile(pubPath, "utf8")).trim();
+    const pub = (await fs3.readFile(pubPath, "utf8")).trim();
     if (!pub) {
       log.warn("ssh-keygen produced no public key.");
       return null;
     }
-    await fs2.chmod(keyPath, 384).catch(() => {
+    await fs3.chmod(keyPath, 384).catch(() => {
     });
     return { publicKey: pub };
   } catch (err) {
@@ -473,7 +506,7 @@ async function writeGitignore(dir, log) {
   const file = path3.join(dir, ".gitignore");
   let content = "";
   try {
-    content = await fs2.readFile(file, "utf8");
+    content = await fs3.readFile(file, "utf8");
   } catch {
   }
   const present = new Set(content.split("\n").map((l) => l.trim()));
@@ -483,23 +516,23 @@ async function writeGitignore(dir, log) {
   if (next.length > 0 && !next.endsWith("\n")) next += "\n";
   if (!content.trim()) next += "# genex (deploy key + local metadata \u2014 never publish)\n";
   next += toAdd.join("\n") + "\n";
-  await fs2.writeFile(file, next);
+  await fs3.writeFile(file, next);
   log.dim(`Updated .gitignore (${toAdd.join(", ")}).`);
 }
 
 // src/lib/store.ts
-import fs4 from "fs/promises";
+import fs5 from "fs/promises";
 import path5 from "path";
 
 // src/lib/env.ts
-import fs3 from "fs/promises";
+import fs4 from "fs/promises";
 import path4 from "path";
 import { spawn as spawn3 } from "child_process";
 async function writeEnvVar(envPath, key, value) {
   let content = "";
   let existed = false;
   try {
-    content = await fs3.readFile(envPath, "utf8");
+    content = await fs4.readFile(envPath, "utf8");
     existed = true;
   } catch {
   }
@@ -519,14 +552,14 @@ async function writeEnvVar(envPath, key, value) {
     next = prefix + assignment + "\n";
     mode = existed ? "appended" : "created";
   }
-  await fs3.mkdir(path4.dirname(envPath), { recursive: true });
-  await fs3.writeFile(envPath, next, { mode: 384 });
+  await fs4.mkdir(path4.dirname(envPath), { recursive: true });
+  await fs4.writeFile(envPath, next, { mode: 384 });
   await restrictFilePermissions(envPath);
   return { mode, path: envPath };
 }
 async function restrictFilePermissions(filePath) {
   if (process.platform !== "win32") {
-    await fs3.chmod(filePath, 384).catch(() => {
+    await fs4.chmod(filePath, 384).catch(() => {
     });
     return;
   }
@@ -575,7 +608,7 @@ async function readUserToken(envPath) {
 async function readTokenFromFile(file) {
   let content;
   try {
-    content = await fs4.readFile(file, "utf8");
+    content = await fs5.readFile(file, "utf8");
   } catch {
     return null;
   }
@@ -591,7 +624,7 @@ function stripQuotes(v) {
 }
 async function readProject(cwd = process.cwd()) {
   try {
-    const raw = await fs4.readFile(getProjectMetadataPath(cwd), "utf8");
+    const raw = await fs5.readFile(getProjectMetadataPath(cwd), "utf8");
     return JSON.parse(raw);
   } catch {
     return null;
@@ -599,9 +632,9 @@ async function readProject(cwd = process.cwd()) {
 }
 async function writeProject(meta, cwd = process.cwd()) {
   const file = getProjectMetadataPath(cwd);
-  await fs4.mkdir(path5.dirname(file), { recursive: true });
-  await fs4.writeFile(file, JSON.stringify(meta, null, 2) + "\n", { mode: 384 });
-  await fs4.chmod(file, 384).catch(() => {
+  await fs5.mkdir(path5.dirname(file), { recursive: true });
+  await fs5.writeFile(file, JSON.stringify(meta, null, 2) + "\n", { mode: 384 });
+  await fs5.chmod(file, 384).catch(() => {
   });
   return { path: file };
 }
@@ -631,24 +664,24 @@ async function runInit(opts) {
   log.plain(c.bold("genex init"));
   log.plain("");
   const templatesDir = getTemplatesDir();
-  const claudeDir = getClaudeDir(opts.dir);
-  log.step(`Setting up your workspace at ${c.cyan(claudeDir)}`);
-  const { copied, skipped } = await copyTemplates(templatesDir, claudeDir, {
-    force: opts.force
-  });
-  if (copied.length > 0) {
-    log.success(`Added ${copied.length} file${copied.length === 1 ? "" : "s"}.`);
-    for (const f of copied) log.dim(`  + ${f}`);
-  }
-  if (skipped.length > 0) {
-    log.info(
-      `Left ${skipped.length} existing file${skipped.length === 1 ? "" : "s"} untouched.`
-    );
-    for (const f of skipped) log.dim(`  = ${f}`);
-  }
-  if (copied.length === 0 && skipped.length === 0) {
-    log.info("No template files to install.");
-  }
+  const targets = resolveAgentTargets({ dir: opts.dir, agents: opts.agents });
+  log.step(
+    `Installing Genex skills for: ${targets.map((t) => c.cyan(t.label)).join(", ")}`
+  );
+  let totalNew = 0;
+  let totalUpdated = 0;
+  for (const t of targets) {
+    const src = t.full ? templatesDir : path6.join(templatesDir, "skills");
+    const dest = t.full ? t.baseDir : path6.join(t.baseDir, "skills");
+    const { copied, updated } = await copyTemplates(src, dest, { force: opts.force });
+    const added = copied.length - updated.length;
+    totalNew += added;
+    totalUpdated += updated.length;
+    log.dim(`  ${t.label}: ${added} added, ${updated.length} refreshed \u2192 ${dest}`);
+  }
+  log.success(
+    `Skills ready (${totalNew} added, ${totalUpdated} refreshed across ${targets.length} agent${targets.length === 1 ? "" : "s"}).`
+  );
   log.plain("");
   if (opts.noAuth) {
     log.info("Skipping authorization (--no-auth).");
@@ -703,7 +736,7 @@ async function runInit(opts) {
 
 // src/lib/deploy.ts
 import { spawn as spawn4 } from "child_process";
-import fs5 from "fs/promises";
+import fs6 from "fs/promises";
 import os2 from "os";
 import path7 from "path";
 function run(cmd, args, env) {
@@ -737,24 +770,24 @@ async function deployGame(sshUrl, opts, log) {
     log.success("Built.");
   }
   const distDir = path7.join(cwd, "dist");
-  const siteDir = await isDir(distDir) ? distDir : cwd;
+  const siteDir = await isDir2(distDir) ? distDir : cwd;
   if (siteDir === cwd) {
     await writeGitignore(cwd, log);
   }
   const rel = path7.relative(cwd, siteDir) || ".";
   try {
-    await fs5.access(path7.join(siteDir, "index.html"));
+    await fs6.access(path7.join(siteDir, "index.html"));
   } catch {
     log.warn(`No index.html in ${rel} \u2014 GitHub Pages needs one to serve the game.`);
   }
   await warnIfAbsolutePaths(siteDir, log);
-  await fs5.writeFile(path7.join(siteDir, ".nojekyll"), "");
+  await fs6.writeFile(path7.join(siteDir, ".nojekyll"), "");
   const keyPath = path7.resolve(cwd, KEY_NAME);
   if (!await fileExists(keyPath)) {
     log.warn(`No deploy key (${KEY_NAME}) here \u2014 run \`genex init\` in this folder first.`);
     return false;
   }
-  const gitDir = await fs5.mkdtemp(path7.join(os2.tmpdir(), "genex-deploy-"));
+  const gitDir = await fs6.mkdtemp(path7.join(os2.tmpdir(), "genex-deploy-"));
   const gitEnv = { GIT_DIR: gitDir, GIT_WORK_TREE: siteDir };
   try {
     if ((await run("git", ["init", "-q"], gitEnv)).code !== 0) {
@@ -790,28 +823,28 @@ async function deployGame(sshUrl, opts, log) {
     if (tail) log.dim(`  ${tail}`);
     return false;
   } finally {
-    await fs5.rm(gitDir, { recursive: true, force: true }).catch(() => {
+    await fs6.rm(gitDir, { recursive: true, force: true }).catch(() => {
     });
   }
 }
 async function hasBuildScript(cwd) {
   try {
-    const pkg = JSON.parse(await fs5.readFile(path7.join(cwd, "package.json"), "utf8"));
+    const pkg = JSON.parse(await fs6.readFile(path7.join(cwd, "package.json"), "utf8"));
     return Boolean(pkg.scripts?.build);
   } catch {
     return false;
   }
 }
-async function isDir(p) {
+async function isDir2(p) {
   try {
-    return (await fs5.stat(p)).isDirectory();
+    return (await fs6.stat(p)).isDirectory();
   } catch {
     return false;
   }
 }
 async function fileExists(p) {
   try {
-    await fs5.access(p);
+    await fs6.access(p);
     return true;
   } catch {
     return false;
@@ -820,7 +853,7 @@ async function fileExists(p) {
 async function warnIfAbsolutePaths(siteDir, log) {
   let html;
   try {
-    html = await fs5.readFile(path7.join(siteDir, "index.html"), "utf8");
+    html = await fs6.readFile(path7.join(siteDir, "index.html"), "utf8");
   } catch {
     return;
   }
@@ -918,7 +951,7 @@ async function runPreview(opts) {
 import path9 from "path";
 
 // src/lib/assets.ts
-import fs6 from "fs/promises";
+import fs7 from "fs/promises";
 import path8 from "path";
 function slugify(input) {
   const s = input.toLowerCase().normalize("NFKD").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 50).replace(/-+$/g, "");
@@ -928,8 +961,8 @@ async function downloadToFile(url, dest, headers) {
   const res = await fetch(url, { headers });
   if (!res.ok) throw new Error(`download failed (HTTP ${res.status}) for ${url}`);
   const buf = Buffer.from(await res.arrayBuffer());
-  await fs6.mkdir(path8.dirname(dest), { recursive: true });
-  await fs6.writeFile(dest, buf);
+  await fs7.mkdir(path8.dirname(dest), { recursive: true });
+  await fs7.writeFile(dest, buf);
   return buf.byteLength;
 }
 
@@ -1099,7 +1132,8 @@ ${c.bold("Options for the generators (`model` `skybox` `sfx` `texture`)")}
 ${c.bold("Options for `init`")}
   <name>               Project name (positional; default: current directory name).
   --name <name>        Same as the positional name.
-  --dir <path>         Destination workspace (default: ~/.claude).
+  --agents <list>      Agents to install skills for (claude,codex,cursor; default: auto-detect).
+  --dir <path>         Single destination workspace (overrides --agents).
   --env <path>         Token env file (default: ~/.genex/env).
   --auth-url <url>     Override the auth site (default: ${DEFAULT_AUTH_URL}).
   --api-url <url>      Override the API base URL (default: ${DEFAULT_API_URL}).
@@ -1151,6 +1185,7 @@ function parseArgs(argv) {
     "--auth-url",
     "--api-url",
     "--colyseus-url",
+    "--agents",
     "--name",
     "--title",
     "--description",
@@ -1233,6 +1268,9 @@ function applyValueFlag(options, flag, value) {
     case "--colyseus-url":
       options.colyseusUrl = value;
       break;
+    case "--agents":
+      options.agents = value.split(",").map((s) => s.trim().toLowerCase()).filter(Boolean);
+      break;
     case "--name":
       options.name = value;
       break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genex-ai/cli-demo",
-  "version": "0.3.0",
+  "version": "0.4.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-getting-started/SKILL.md

@@ -11,11 +11,15 @@ architecture, and team-ready workflows.
 
 ## What got installed
 
-Everything under `~/.claude`:
-
-- **skills/** - reusable Genex skills for 3D browser-game work.
-- **agents/** - example subagent definitions.
-- **commands/** - example slash commands.
+`genex init` installs the Genex skills into **every coding agent it detects** —
+Claude Code (`~/.claude`), Codex (`~/.codex`), and Cursor (`~/.cursor`) — so the
+same skills are available whichever agent you build with. Re-running `init`
+always refreshes the genex-owned skills to the latest version (your own files
+are never touched).
+
+- **skills/** - reusable Genex skills for 3D browser-game work (all agents).
+- **agents/** - example subagent definitions (Claude Code).
+- **commands/** - example slash commands (Claude Code).
 
 Start with `$genex-threejs-skill-router` for broad game or graphics requests.
 It routes the agent to focused skills for cameras, procedural geometry,