@silicaclaw/cli 1.0.0-beta.13 → 1.0.0-beta.15

package/CHANGELOG.md

@@ -14,6 +14,8 @@
 - `silicaclaw update` guidance polish:
   - prioritize zero-setup `npx` flow
   - clarify global install is optional
+  - hide global-install recommendation during `npx` runtime to avoid repeated `EACCES` loops
+  - add explicit `command not found` alias guidance for first-run shells
 - README first-screen and structure polish:
   - fixed v1.0 beta project positioning
   - added concise feature summary

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@silicaclaw/cli",
-  "version": "1.0.0-beta.13",
+  "version": "1.0.0-beta.15",
   "private": false,
   "publishConfig": {
     "access": "public"

package/scripts/silicaclaw-cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 import { spawnSync } from "node:child_process";
-import { existsSync, readFileSync } from "node:fs";
+import { accessSync, constants, existsSync, readFileSync } from "node:fs";
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
@@ -58,7 +58,22 @@ function isNpxRun() {
   return ROOT_DIR.includes("/.npm/_npx/");
 }
 
+function canWriteGlobalPrefix() {
+  try {
+    const prefixResult = runCapture("npm", ["prefix", "-g"]);
+    if ((prefixResult.status ?? 1) !== 0) return false;
+    const prefix = String(prefixResult.stdout || "").trim();
+    if (!prefix) return false;
+    const targetDir = resolve(prefix, "lib", "node_modules");
+    accessSync(targetDir, constants.W_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 function showUpdateGuide(current, latest, beta) {
+  const npxRuntime = isNpxRun();
   console.log("SilicaClaw update check");
   console.log(`current: ${current}`);
   console.log(`latest : ${latest || "-"}`);
@@ -82,12 +97,21 @@ function showUpdateGuide(current, latest, beta) {
   console.log("   alias silicaclaw='npx -y @silicaclaw/cli@beta'");
   console.log("   silicaclaw version");
   console.log("");
-  console.log("3) global install mode (optional)");
-  console.log("   npm i -g @silicaclaw/cli@beta");
-  console.log("   silicaclaw version");
-  console.log("");
-  if (isNpxRun()) {
+  const writableGlobal = canWriteGlobalPrefix();
+  if (!npxRuntime && writableGlobal) {
+    console.log("3) global install mode (optional)");
+    console.log("   npm i -g @silicaclaw/cli@beta");
+    console.log("   silicaclaw version");
+    console.log("");
+  } else if (!npxRuntime) {
+    console.log("Global install skipped: current npm global directory is not writable (likely EACCES).");
+    console.log("Use npx or alias mode above.");
+    console.log("");
+  }
+  if (npxRuntime) {
     console.log("Detected npx runtime: use npx commands above for immediate update.");
+    console.log("If `silicaclaw: command not found`, run:");
+    console.log("alias silicaclaw='npx -y @silicaclaw/cli@beta'");
   }
 }