@genrupt/cli 0.1.2 → 0.1.3

package/README.md

@@ -10,7 +10,7 @@ Use this when setting up Genrupt for an agent:
 npx -y @genrupt/cli@latest agent install
 ```
 
-This installs or updates the global CLI, checks auth, installs Genrupt skills for the detected agent, and writes a local runtime manifest.
+This checks auth, installs Genrupt skills for the detected agent, and writes a local runtime manifest. It also tries to install or update the global CLI, but global npm install failures do not block the skills/runtime setup; use the printed `npx` commands when global npm install is restricted on the machine.
 
 ## Install
 
@@ -52,6 +52,8 @@ genrupt mcp serve
 
 Claude Code can then call Genrupt from chat while the local process can read user-approved local file paths.
 
+If the global `genrupt` command is unavailable, setup registers the bridge through `npx -y @genrupt/cli@latest` so Claude Code can still start it.
+
 ## Doctor
 
 ```bash

package/dist/agent.js

@@ -30,7 +30,7 @@ async function runCommand(command, args, timeoutMs = 120_000) {
 async function getGlobalNodeModulesPath() {
     return runCommand("npm", ["root", "-g"]);
 }
-async function getGlobalCliPackageVersion() {
+export async function getGlobalCliPackageVersion() {
     try {
         const globalRoot = await getGlobalNodeModulesPath();
         const packageJsonPath = path.join(globalRoot, "@genrupt", "cli", "package.json");
@@ -48,7 +48,7 @@ async function ensureGlobalCli(minimumVersion) {
     const currentVersion = await getGlobalCliPackageVersion();
     if (currentVersion && isVersionAtLeast(currentVersion, minimumVersion)) {
         console.log(`Genrupt CLI is installed globally (${currentVersion}).`);
-        return;
+        return true;
     }
     const reason = currentVersion
         ? `Global Genrupt CLI ${currentVersion} is below required ${minimumVersion}.`
@@ -60,15 +60,18 @@ async function ensureGlobalCli(minimumVersion) {
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
-        throw new Error(`Could not install ${CLI_PACKAGE_NAME}@latest globally.\n${message}\n` +
-            `Run manually: npm install -g ${CLI_PACKAGE_NAME}@latest`);
+        console.log(`Could not install ${CLI_PACKAGE_NAME}@latest globally.\n${message}\n` +
+            "Continuing with the current npx CLI run.");
+        return false;
     }
     const nextVersion = await getGlobalCliPackageVersion();
     if (!nextVersion || !isVersionAtLeast(nextVersion, minimumVersion)) {
-        throw new Error(`Global ${CLI_PACKAGE_NAME} did not report a usable version after install.\n` +
-            `Run manually: npm install -g ${CLI_PACKAGE_NAME}@latest`);
+        console.log(`Global ${CLI_PACKAGE_NAME} did not report a usable version after install.\n` +
+            "Continuing with the current npx CLI run.");
+        return false;
     }
     console.log(`Genrupt CLI is installed globally (${nextVersion}).`);
+    return true;
 }
 async function ensureAuth(options) {
     try {
@@ -87,6 +90,7 @@ export async function installAgentRuntime(options = {}) {
     let stage = "download_runtime";
     let runtimeVersion;
     let requiredCliVersion;
+    let globalCliReady = Boolean(options.skipGlobalInstall);
     await emitRuntimeTelemetry({
         eventType: "agent_install_started",
         command: "agent_install",
@@ -102,7 +106,7 @@ export async function installAgentRuntime(options = {}) {
         requiredCliVersion = runtime.requiresCliVersion;
         if (!options.skipGlobalInstall) {
             stage = "global_cli_install";
-            await ensureGlobalCli(runtime.requiresCliVersion);
+            globalCliReady = await ensureGlobalCli(runtime.requiresCliVersion);
         }
         if (!options.skipAuth) {
             stage = "auth";
@@ -128,6 +132,7 @@ export async function installAgentRuntime(options = {}) {
                 stage,
                 skipAuth: Boolean(options.skipAuth),
                 skipGlobalInstall: Boolean(options.skipGlobalInstall),
+                globalCliReady,
             },
         }, { origin });
         throw error;
@@ -142,8 +147,17 @@ export async function installAgentRuntime(options = {}) {
         metadata: {
             skipAuth: Boolean(options.skipAuth),
             skipGlobalInstall: Boolean(options.skipGlobalInstall),
+            globalCliReady,
         },
     }, { origin });
     console.log();
     console.log("Genrupt agent runtime is ready.");
+    if (!globalCliReady) {
+        console.log();
+        console.log("Global CLI install was not completed. Use npx commands on this machine:");
+        console.log(`  npx -y ${CLI_PACKAGE_NAME}@latest doctor`);
+        console.log(`  npx -y ${CLI_PACKAGE_NAME}@latest setup claude-code`);
+        console.log();
+        console.log(`To repair the global command later: npm install -g ${CLI_PACKAGE_NAME}@latest`);
+    }
 }

package/dist/constants.js

@@ -3,5 +3,5 @@ export const DEFAULT_MCP_SERVER_URL = `${DEFAULT_ORIGIN}/api/agent/mcp`;
 export const OAUTH_DEVICE_GRANT_TYPE = "urn:ietf:params:oauth:grant-type:device_code";
 export const OAUTH_SCOPE = "mcp";
 export const CLI_CLIENT_NAME = "Genrupt CLI";
-export const CLI_VERSION = "0.1.2";
+export const CLI_VERSION = "0.1.3";
 export const ACCESS_TOKEN_REFRESH_SKEW_MS = 60_000;

package/dist/setup.js

@@ -1,14 +1,33 @@
 import { spawnSync } from "node:child_process";
 import { assertLoggedIn } from "./auth.js";
+import { CLI_VERSION } from "./constants.js";
+import { getGlobalCliPackageVersion } from "./agent.js";
+import { CLI_PACKAGE_NAME, isVersionAtLeast } from "./version.js";
 function runClaude(args) {
     return spawnSync("claude", args, {
         stdio: "inherit",
         shell: process.platform === "win32",
     });
 }
+async function resolveBridgeCommand() {
+    const globalVersion = await getGlobalCliPackageVersion();
+    if (globalVersion && isVersionAtLeast(globalVersion, CLI_VERSION)) {
+        return {
+            command: ["genrupt", "mcp", "serve"],
+            usingGlobalCli: true,
+            globalVersion,
+        };
+    }
+    return {
+        command: ["npx", "-y", `${CLI_PACKAGE_NAME}@latest`, "mcp", "serve"],
+        usingGlobalCli: false,
+        globalVersion,
+    };
+}
 export async function setupClaudeCode(options = {}) {
     await assertLoggedIn();
     const scope = options.scope ?? "user";
+    const bridgeCommand = await resolveBridgeCommand();
     if (options.replace) {
         runClaude(["mcp", "remove", "genrupt"]);
     }
@@ -21,9 +40,7 @@ export async function setupClaudeCode(options = {}) {
         scope,
         "genrupt",
         "--",
-        "genrupt",
-        "mcp",
-        "serve",
+        ...bridgeCommand.command,
     ];
     const result = runClaude(args);
     if (result.error || result.status !== 0) {
@@ -40,5 +57,10 @@ export async function setupClaudeCode(options = {}) {
     }
     console.log();
     console.log("Genrupt local MCP bridge is installed for Claude Code.");
+    if (!bridgeCommand.usingGlobalCli) {
+        console.log(bridgeCommand.globalVersion
+            ? `Global Genrupt CLI ${bridgeCommand.globalVersion} is below ${CLI_VERSION}, so Claude Code will launch the bridge with npx.`
+            : "No usable global Genrupt CLI was found, so Claude Code will launch the bridge with npx.");
+    }
     console.log("Start a new Claude Code chat, then ask Genrupt to upload local product files or run a workflow.");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genrupt/cli",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Genrupt CLI for OAuth login, local file uploads, and local MCP bridge setup.",
   "license": "MIT",
   "repository": {