marvelous-ui-library 1.0.1 → 1.0.2

package/README.md

@@ -7,7 +7,7 @@ npx marvelous-ui-library@latest init
 npx marvelous-ui-library@latest add dialog tabs toast
 ```
 
-`init` detects the project and supported agent configuration. In an interactive terminal it asks whether to install the Pack in this project or in your user profile. Enter a Polar license key in the hidden prompt for Pro, or press Enter for Free. For automation, set `MARVELOUS_LICENSE_KEY` for Pro and optionally use `--scope project|user`. A noninteractive invocation without a key defaults to Free in the current project. `--edition free|pro` remains available for existing scripts.
+`init` detects the project and supported agent configuration. In an interactive terminal it asks whether to install the Pack in this project or in your user profile. Enter a Polar license key in the hidden prompt for Pro, or press Enter for Free. User setup then asks which agents to connect and registers Codex and Claude Code directly. For automation, set `MARVELOUS_LICENSE_KEY` for Pro and use `--scope user --clients codex,claude` to choose agents; `--clients none` installs only the shared Pack. Rerunning user setup removes a previously selected plugin when you deselect that agent. A noninteractive invocation without a key defaults to Free in the current project. `--edition free|pro` remains available for existing scripts. Other agents can use project setup or the manual instructions in the Pack's `docs/MCP.md`.
 
 The Pro Pack requires a Polar license key for the first download and for newer releases. A supplied invalid key causes an error. The key is not written to a project file. A project Pack remains at its installed version until you run:
 

package/bin.mjs

@@ -5,6 +5,7 @@ import { join, resolve } from "node:path";
 import { createInterface } from "node:readline/promises";
 import { Writable } from "node:stream";
 import { locations, readState, latestRelease, downloadRelease, installPack, addComponents, detectFramework, listProArchives, readProArchive } from "./lib/installer.mjs";
+import { checkUserAgents, configureUserAgents, parseUserAgents, readUserAgents } from "./lib/agents.mjs";
 
 const HELP = `Marvelous UI
 
@@ -13,7 +14,7 @@ const HELP = `Marvelous UI
   npx marvelous-ui-library@latest update [--scope project|user]
   npx marvelous-ui-library@latest restore [--scope project|user] [--version 1.1.0]
 
-Options: --project path, --clients names. At init, press Enter for Free or enter a Polar key for Pro. In automation, set MARVELOUS_LICENSE_KEY for Pro.
+Options: --project path, --clients names. User setup supports codex,claude,none. At init, press Enter for Free or enter a Polar key for Pro. In automation, set MARVELOUS_LICENSE_KEY for Pro.
 `;
 
 function options(args) {
@@ -69,8 +70,22 @@ function chosenOut(project, supplied, componentState) {
 }
 
 function pluginRefresh(place) {
-  console.log("If your agent installed a copy of the plugin, register the updated Pack again:");
-  execFileSync(process.execPath, [join(place.pack, "scripts", "init-agent.mjs"), "--plugin"], { stdio: "inherit" });
+  if (place.scope !== "user") return;
+  const agents = readUserAgents(place);
+  if (agents.length) {
+    const names = configureUserAgents(place, agents);
+    console.log(`Updated agent plugins: ${names.join(", ")}.`);
+  }
+}
+
+function defaultUserAgents(place) {
+  const previous = readUserAgents(place);
+  if (existsSync(join(place.base, "agents.json"))) return previous.length ? previous.join(",") : "none";
+  for (const name of ["codex", "claude"]) {
+    try { execFileSync(name, ["--version"], { stdio: "ignore" }); return name; }
+    catch {}
+  }
+  return "none";
 }
 
 async function init(opts, project) {
@@ -82,9 +97,17 @@ async function init(opts, project) {
   const edition = opts.edition ?? (key || current?.edition === "pro" ? "pro" : "free");
   if (!["project", "user"].includes(scope) || !["free", "pro"].includes(edition)) throw new Error("Choose --scope project|user and --edition free|pro.");
   if (opts.edition === "free" && key) throw new Error("A Polar key was provided with --edition free. Remove the key or choose Pro.");
+  let selectedAgents = null;
+  if (scope === "user") {
+    const choice = opts.clients ?? (process.stdin.isTTY
+      ? await ask("Which agents should be connected? [codex,claude,none] (comma-separated) ", defaultUserAgents(place))
+      : existsSync(join(place.base, "agents.json")) ? defaultUserAgents(place) : "none");
+    selectedAgents = parseUserAgents(choice);
+  }
+  if (selectedAgents) checkUserAgents(selectedAgents);
   const componentState = readState(place.components);
   const hasComponents = !!(current && componentState?.slugs?.length && componentState.sourceScope === scope);
-  console.log(`Marvelous UI: ${edition} Pack, ${scope} scope, ${detectFramework(project)} project`);
+  console.log(`Marvelous UI: ${edition} Pack, ${scope === "user" ? "user profile" : `${detectFramework(project)} project`}${key ? ", Polar key received" : ""}.`);
   if (!current || current.edition !== edition) {
     const meta = await latestRelease(edition);
     const bytes = await downloadRelease(edition, meta, edition === "pro" ? key || await licenseKey() : "");
@@ -109,10 +132,10 @@ async function init(opts, project) {
     if (opts.clients) args.push("--clients", opts.clients);
     execFileSync(process.execPath, args, { stdio: "inherit" });
   } else {
-    console.log("Register the user Pack with your agent using these commands:");
-    execFileSync(process.execPath, [join(place.pack, "scripts", "init-agent.mjs"), "--plugin"], { stdio: "inherit" });
+    const names = configureUserAgents(place, selectedAgents);
+    console.log(names.length ? `Connected for all projects: ${names.join(", ")}.` : "No agent connected by choice.");
   }
-  console.log("Ready. Ask your coding agent to build a UI with Marvelous UI.");
+  console.log(scope === "user" && !selectedAgents.length ? "Pack installed." : "Ready. Restart your agent to load Marvelous UI.");
 }
 
 async function restore(opts, project) {

package/lib/agents.mjs

@@ -0,0 +1,69 @@
+import { execFileSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+
+const SUPPORTED = ["codex", "claude"];
+const LABELS = { codex: "Codex", claude: "Claude Code" };
+
+export function parseUserAgents(value) {
+  const names = [...new Set(value.toLowerCase().split(",").map((name) => name.trim()).filter(Boolean))];
+  if (names.length === 1 && names[0] === "none") return [];
+  const unsupported = names.filter((name) => !SUPPORTED.includes(name));
+  if (unsupported.length) throw new Error(`User setup supports Codex and Claude Code. Unsupported choice: ${unsupported.join(", ")}. Other agents can use project setup or the manual guide.`);
+  if (!names.length) throw new Error("Choose codex, claude, both, or none.");
+  return names;
+}
+
+export function readUserAgents(place) {
+  const file = join(place.base, "agents.json");
+  if (!existsSync(file)) return [];
+  const state = JSON.parse(readFileSync(file, "utf8"));
+  if (state.schema !== 1 || !Array.isArray(state.clients) || state.clients.some((name) => !SUPPORTED.includes(name))) {
+    throw new Error(`Unsupported Marvelous UI agent state: ${file}`);
+  }
+  return state.clients;
+}
+
+function runAgent(command, args, runner) {
+  try { runner(command, args, { encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] }); }
+  catch (error) {
+    const detail = String(error.stderr ?? error.message ?? "").trim().split(/\r?\n/).at(-1);
+    throw new Error(`${LABELS[command]} setup failed${detail ? `: ${detail}` : "."} The Pack remains installed. Rerun init to retry agent setup.`);
+  }
+}
+
+export function checkUserAgents(clients, runner = execFileSync) {
+  for (const client of clients) runAgent(client, ["--version"], runner);
+}
+
+export function configureUserAgents(place, clients, runner = execFileSync) {
+  const prior = readUserAgents(place);
+  for (const client of clients) {
+    if (client === "codex") {
+      runAgent("codex", ["plugin", "marketplace", "add", place.pack], runner);
+      runAgent("codex", ["plugin", "add", "marvelous-ui@marvelous-ui"], runner);
+    } else {
+      if (prior.includes("claude")) {
+        runAgent("claude", ["plugin", "marketplace", "update", "marvelous-ui"], runner);
+        runAgent("claude", ["plugin", "update", "marvelous-ui@marvelous-ui"], runner);
+      } else {
+        runAgent("claude", ["plugin", "marketplace", "add", place.pack], runner);
+        runAgent("claude", ["plugin", "install", "marvelous-ui@marvelous-ui", "--scope", "user"], runner);
+      }
+    }
+  }
+  for (const client of prior.filter((name) => !clients.includes(name))) {
+    if (client === "codex") runAgent("codex", ["plugin", "remove", "marvelous-ui@marvelous-ui"], runner);
+    else runAgent("claude", ["plugin", "uninstall", "marvelous-ui@marvelous-ui", "--scope", "user"], runner);
+  }
+  saveUserAgents(place, clients);
+  return clients.map((name) => LABELS[name]);
+}
+
+function saveUserAgents(place, clients) {
+  const file = join(place.base, "agents.json");
+  mkdirSync(place.base, { recursive: true });
+  const temporary = `${file}.${process.pid}.tmp`;
+  writeFileSync(temporary, JSON.stringify({ schema: 1, clients }, null, 2) + "\n", { mode: 0o600 });
+  renameSync(temporary, file);
+}

package/lib/installer.mjs

@@ -1,4 +1,4 @@
-import { execFileSync } from "node:child_process";
+import { execFileSync, execSync } from "node:child_process";
 import { existsSync, lstatSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { homedir, tmpdir } from "node:os";
 import { dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
@@ -193,9 +193,15 @@ export function installPack(bytes, edition, meta, place, { installDependencies =
     validPack(stage, edition, meta.version);
     if (edition === "pro") saveProArchive(bytes, meta, place);
     if (installDependencies) {
-      const npmArgs = ["ci", "--omit=dev", "--ignore-scripts", "--no-audit"];
-      if (process.env.npm_execpath?.endsWith(".js")) execFileSync(process.execPath, [process.env.npm_execpath, ...npmArgs], { cwd: stage, stdio: "inherit" });
-      else execFileSync("npm", npmArgs, { cwd: stage, stdio: "inherit", shell: process.platform === "win32" });
+      const npmArgs = ["ci", "--omit=dev", "--ignore-scripts", "--no-audit", "--no-fund", "--silent"];
+      try {
+        if (process.env.npm_execpath?.endsWith(".js")) execFileSync(process.execPath, [process.env.npm_execpath, ...npmArgs], { cwd: stage, stdio: ["ignore", "pipe", "pipe"] });
+        else if (process.platform === "win32") execSync(`npm ${npmArgs.join(" ")}`, { cwd: stage, stdio: ["ignore", "pipe", "pipe"] });
+        else execFileSync("npm", npmArgs, { cwd: stage, stdio: ["ignore", "pipe", "pipe"] });
+      } catch (error) {
+        const detail = String(error.stderr ?? error.message ?? "").trim().split(/\r?\n/).at(-1);
+        throw new Error(`The Pack dependencies could not be installed${detail ? `: ${detail}` : "."}`);
+      }
     }
     beforeCommit?.(stage);
     if (existsSync(backup)) throw new Error("A previous installation is still being recovered.");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "marvelous-ui-library",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Install and update the Marvelous UI component Pack for coding agents",
   "type": "module",
   "license": "MIT",