@silicaclaw/cli 1.0.0-beta.11 → 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.11",
+  "version": "1.0.0-beta.13",
   "private": false,
   "publishConfig": {
     "access": "public"

package/scripts/quickstart.sh

@@ -79,6 +79,61 @@ EOF
   return 0
 }
 
+default_system_bin_dir() {
+  if [ -d "/usr/local/bin" ]; then
+    printf '/usr/local/bin'
+    return 0
+  fi
+  if [ -d "/opt/homebrew/bin" ]; then
+    printf '/opt/homebrew/bin'
+    return 0
+  fi
+  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}"
@@ -208,11 +263,14 @@ if command -v silicaclaw >/dev/null 2>&1; then
 else
   echo "将尝试无 sudo 安装 silicaclaw 命令到 PATH 中可写目录。"
   BIN_DIR="$(first_writable_path_dir || true)"
+  INSTALLED=0
   if [ -n "${BIN_DIR:-}" ]; then
     if install_command_shim "$BIN_DIR"; then
       echo "命令已安装: $BIN_DIR/silicaclaw"
+      hash -r || true
       if command -v silicaclaw >/dev/null 2>&1; then
         echo "验证成功: $(command -v silicaclaw)"
+        INSTALLED=1
       else
         echo "命令已写入，但当前 shell 未立即识别。请新开终端后运行 silicaclaw。"
       fi
@@ -221,7 +279,42 @@ else
     fi
   else
     echo "当前 PATH 中没有可写目录，无法无 sudo 安装系统命令。"
-    echo "你仍可直接使用: npx @silicaclaw/cli@beta <command>"
+  fi
+
+  if [ "$INSTALLED" != "1" ]; then
+    SYS_BIN_DIR="$(default_system_bin_dir)"
+    echo "为保证开箱即用体验，建议安装到系统目录: $SYS_BIN_DIR/silicaclaw"
+    if ask_yes_no "是否使用 sudo 安装系统命令？" "Y"; then
+      run_cmd "sudo mkdir -p \"$SYS_BIN_DIR\""
+      run_cmd "sudo tee \"$SYS_BIN_DIR/silicaclaw\" >/dev/null <<'EOF'
+#!/usr/bin/env bash
+set -euo pipefail
+exec node \"$WORK_DIR/scripts/silicaclaw-cli.mjs\" \"\$@\"
+EOF"
+      run_cmd "sudo chmod +x \"$SYS_BIN_DIR/silicaclaw\""
+      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 安装。"
+    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("");