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

package/CHANGELOG.md

@@ -8,6 +8,12 @@
   - `INSTALL.md`
   - `DEMO_GUIDE.md`
   - `RELEASE_NOTES_v1.0.md`
+- CLI onboarding install UX polish:
+  - added shell alias fallback (`silicaclaw -> npx @silicaclaw/cli@beta`) when global install is unavailable
+  - reduced reliance on manual PATH/env edits for first-run success
+- `silicaclaw update` guidance polish:
+  - prioritize zero-setup `npx` flow
+  - clarify global install is optional
 - README first-screen and structure polish:
   - fixed v1.0 beta project positioning
   - added concise feature summary

package/INSTALL.md

@@ -57,6 +57,14 @@ silicaclaw gateway status
 silicaclaw gateway stop
 ```
 
+If global install fails with `EACCES`, use alias mode (no PATH edits):
+
+```bash
+alias silicaclaw='npx -y @silicaclaw/cli@beta'
+silicaclaw onboard
+silicaclaw update
+```
+
 ## 3. Run
 
 Start local console:

package/README.md

@@ -92,6 +92,14 @@ silicaclaw gateway status
 silicaclaw gateway stop
 ```
 
+If global install is blocked by system permissions (`EACCES`), use alias mode:
+
+```bash
+alias silicaclaw='npx -y @silicaclaw/cli@beta'
+silicaclaw onboard
+silicaclaw update
+```
+
 ## Quick Start (OpenClaw-style)
 
 ### 1. Prerequisites

package/package.json

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

package/scripts/quickstart.sh

@@ -91,6 +91,49 @@ default_system_bin_dir() {
   printf '/usr/local/bin'
 }
 
+detect_shell_rc_file() {
+  local sh_name="${SHELL:-}"
+  case "$sh_name" in
+    */zsh) printf '%s' "$HOME/.zshrc" ;;
+    */bash) printf '%s' "$HOME/.bashrc" ;;
+    *)
+      if [ -n "${ZSH_VERSION:-}" ]; then
+        printf '%s' "$HOME/.zshrc"
+      else
+        printf '%s' "$HOME/.bashrc"
+      fi
+      ;;
+  esac
+}
+
+install_npx_alias() {
+  local rc_file
+  rc_file="$(detect_shell_rc_file)"
+  local begin_mark="# >>> silicaclaw npx alias >>>"
+  local end_mark="# <<< silicaclaw npx alias <<<"
+  local alias_line="alias silicaclaw='npx -y @silicaclaw/cli@beta'"
+
+  mkdir -p "$(dirname "$rc_file")"
+  touch "$rc_file"
+
+  if grep -Fq "$begin_mark" "$rc_file"; then
+    echo "已存在 silicaclaw alias 配置: $rc_file"
+    return 0
+  fi
+
+  {
+    echo ""
+    echo "$begin_mark"
+    echo "$alias_line"
+    echo "$end_mark"
+  } >>"$rc_file"
+
+  echo "已写入 alias 到: $rc_file"
+  echo "执行以下命令即可在当前 shell 立即生效："
+  echo "source \"$rc_file\""
+  return 0
+}
+
 ask_yes_no() {
   local prompt="$1"
   local default="${2:-Y}"
@@ -252,11 +295,25 @@ EOF"
       hash -r || true
       if command -v silicaclaw >/dev/null 2>&1; then
         echo "验证成功: $(command -v silicaclaw)"
+        INSTALLED=1
       else
         echo "安装完成，但当前 shell 未刷新。请新开终端后运行 silicaclaw。"
       fi
     else
-      echo "已跳过 sudo 安装。你仍可使用: npx @silicaclaw/cli@beta <command>"
+      echo "已跳过 sudo 安装。"
+    fi
+  fi
+
+  if [ "$INSTALLED" != "1" ]; then
+    echo "无需改 PATH/环境变量，也可一键使用 silicaclaw。"
+    if ask_yes_no "是否自动写入 shell alias（silicaclaw -> npx @silicaclaw/cli@beta）？" "Y"; then
+      if install_npx_alias; then
+        echo "alias 安装完成。新开终端后可直接使用 silicaclaw。"
+      else
+        echo "alias 安装失败。可继续使用: npx @silicaclaw/cli@beta <command>"
+      fi
+    else
+      echo "你仍可继续使用: npx @silicaclaw/cli@beta <command>"
     fi
   fi
 fi

package/scripts/silicaclaw-cli.mjs

@@ -73,11 +73,16 @@ function showUpdateGuide(current, latest, beta) {
   }
   console.log("");
   console.log("Recommended commands:");
-  console.log("1) npx mode (no global install)");
+  console.log("1) npx mode (recommended, zero setup)");
   console.log("   npx @silicaclaw/cli@beta onboard");
   console.log("   npx @silicaclaw/cli@beta connect");
+  console.log("   npx @silicaclaw/cli@beta update");
   console.log("");
-  console.log("2) global install mode");
+  console.log("2) shell alias mode (no global install / no PATH edits)");
+  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("");