omnish 2.1.8 → 2.2.0

package/CHANGELOG.md

@@ -7,6 +7,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.2.0] - 2026-07-11
+
+### Added
+
+- **Windows installer:** `contrib/install-omnish.ps1` at `https://platform.omnish.dev/action/install-omnish.ps1` (`irm … | iex`); nvm-windows and winget paths.
+- **macOS Homebrew path** in `contrib/install-omnish.sh` when Node is below 22.13.
+
+### Changed
+
+- **Install docs:** README and quick-start use per-OS table (Linux, macOS, Windows, WSL); script-first hero line.
+- **Preinstall/runtime errors:** Windows lead with PowerShell installer URL.
+
+## [2.1.9] - 2026-07-11
+
+### Added
+
+- **Platform install script:** `https://platform.omnish.dev/action/install-omnish.sh` served from tunnel-relay; `platform.omnish.dev` in Caddy site block with `tunnel.omnish.dev`.
+
+### Changed
+
+- **Install UX:** README, preinstall, and docs lead with platform installer one-liner; unpkg fallback retained. Installer shows banner, steps, and quick-start path to first `!` command.
+- **`scripts/install-script-url.cjs`:** canonical public installer URL.
+
 ## [2.1.8] - 2026-07-11
 
 ### Changed
@@ -101,6 +124,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Documentation and formatting updates across chat components and feature docs.
 
+[2.2.0]: https://github.com/labKnowledge/omnish/compare/v2.1.9...v2.2.0
+[2.1.9]: https://github.com/labKnowledge/omnish/compare/v2.1.8...v2.1.9
 [2.1.8]: https://github.com/labKnowledge/omnish/compare/v2.1.7...v2.1.8
 [2.1.7]: https://github.com/labKnowledge/omnish/compare/v2.1.6...v2.1.7
 [2.1.6]: https://github.com/labKnowledge/omnish/compare/v2.1.5...v2.1.6

package/README.md

@@ -8,7 +8,17 @@
 
 **Allowlisted inbox → your real shell.** No AI layer: commands run on **your** machine, and only identities you allow can trigger them.
 
-**Try it:** [omnish.dev](https://omnish.dev) · `npm install -g omnish` → **[Quick start](docs/guides/quick-start.md)** (first `!` command in minutes).
+**Try it:** [omnish.dev](https://omnish.dev) · one-command install → **[Quick start](docs/guides/quick-start.md)** (first `!` command in minutes).
+
+```bash
+# Linux / macOS / WSL
+curl -fsSL https://platform.omnish.dev/action/install-omnish.sh | bash
+```
+
+```powershell
+# Windows (PowerShell)
+irm https://platform.omnish.dev/action/install-omnish.ps1 | iex
+```
 
 > The OpenClaw alternative that puts developers back in control.
 
@@ -107,12 +117,23 @@ Each **chat** (WhatsApp DM / Telegram DM) has its own shortcut map on disk (`sho
 
 Names are alphanumeric plus `_`/`-`, max 32 characters; several names are reserved (e.g. `help`, `apps`, `bg`). See `/shortcut help` for the full behavior.
 
-## Install from npm
+## Install
+
+Use the **guided installer** — it upgrades Node when needed and runs `npm install -g omnish`. Pick your OS:
+
+| OS                    | Command                                                                         |
+| --------------------- | ------------------------------------------------------------------------------- |
+| **Linux** (incl. VPS) | `curl -fsSL https://platform.omnish.dev/action/install-omnish.sh \| bash`       |
+| **macOS**             | Same as Linux (Terminal). Uses Homebrew, nvm, or fnm when Node is below 22.13   |
+| **Windows**           | `irm https://platform.omnish.dev/action/install-omnish.ps1 \| iex` (PowerShell) |
+| **WSL**               | Use the Linux command inside your WSL distro                                    |
 
-**Requires Node.js 22.13+** (`node -v`).
+The installer prints next steps: `omnish link` → `omnish allow` → `omnish start` → first `!` command in chat.
 
 ### Already on Node 22.13+
 
+If `node -v` shows v22.13 or newer, you can skip the installer:
+
 ```bash
 npm install -g omnish
 omnish link
@@ -120,15 +141,7 @@ omnish allow +YOUR_E164
 omnish run
 ```
 
-### Old Node (VPS with apt Node 12, etc.)
-
-`npm install -g omnish` will fail on Node below 22.13 — that is expected. **Run the bootstrap installer instead** (upgrades Node, installs build tools on Debian/Ubuntu, then `npm install -g omnish`):
-
-```bash
-curl -fsSL https://unpkg.com/omnish/contrib/install-omnish.sh | bash
-```
-
-The script is published in the npm package (no GitHub clone required). If `npm install -g omnish` failed, the error message prints the same one-liner with your package version.
+`npm install -g omnish` on Node below 22.13 will fail by design — use the installer above (ignore `EBADENGINE` warnings on old distro Node).
 
 **Single phone:** omnish runs on a PC or server; you link it like WhatsApp Web (one QR scan on your phone). See [Quick start — One phone with WhatsApp](docs/guides/quick-start.md#one-phone-with-whatsapp).
 

package/contrib/install-omnish.ps1

@@ -0,0 +1,133 @@
+# omnish bootstrap installer for Windows — Node 22.13+ then npm install -g omnish
+# Canonical URL: https://platform.omnish.dev/action/install-omnish.ps1
+# Usage: irm https://platform.omnish.dev/action/install-omnish.ps1 | iex
+
+$ErrorActionPreference = "Stop"
+
+$OmnishSpec = if ($env:OMNISH_NPM_SPEC) { $env:OMNISH_NPM_SPEC } else { "omnish" }
+$NodeMajor = if ($env:OMNISH_NODE_MAJOR) { $env:OMNISH_NODE_MAJOR } else { "22" }
+$InstallScriptUrl = "https://platform.omnish.dev/action/install-omnish.ps1"
+
+function Write-Banner {
+  Write-Host ""
+  Write-Host "  omnish — allowlisted inbox → your real shell"
+  Write-Host "  ────────────────────────────────────────────"
+  Write-Host "  WhatsApp / Telegram / 20+ channels. No AI layer."
+  Write-Host ""
+}
+
+function Write-Step([string]$Message) {
+  Write-Host ""
+  Write-Host "▸ $Message" -ForegroundColor Cyan
+}
+
+function Get-NodeVersionLabel {
+  try {
+    return (node -v)
+  } catch {
+    return "(not installed)"
+  }
+}
+
+function Test-NodeVersionOk {
+  try {
+    $raw = (node -v) -replace '^v', ''
+    $parts = $raw.Split('.')
+    if ($parts.Count -lt 2) { return $false }
+    $maj = [int]$parts[0]
+    $min = [int]$parts[1]
+    return ($maj -gt 22) -or ($maj -eq 22 -and $min -ge 13)
+  } catch {
+    return $false
+  }
+}
+
+function Install-Omnish {
+  Write-Step "Installing omnish CLI (npm install -g $OmnishSpec) …"
+  npm install -g $OmnishSpec
+  Write-Host ""
+  try {
+    $ver = omnish --version 2>$null
+    if ($ver) { Write-Host "✓ omnish $ver" -ForegroundColor Green }
+    else { Write-Host "✓ omnish installed (reopen PowerShell if omnish not found)" -ForegroundColor Green }
+  } catch {
+    Write-Host "✓ omnish installed (reopen PowerShell if omnish not found)" -ForegroundColor Green
+  }
+  Write-Host ""
+  Write-Host @"
+  You're ready. Run these next (≈2 minutes to first command):
+
+    omnish link            Link WhatsApp (QR) or Telegram (--tg <token>)
+    omnish allow +E164     Allow your phone number
+    omnish start           Run the gateway in the background
+
+  Then message yourself:  !pwd   or   !ls
+
+  Docs: https://omnish.dev · Help: omnish --help
+"@
+}
+
+function Try-NvmWindows {
+  $nvm = Get-Command nvm -ErrorAction SilentlyContinue
+  if (-not $nvm) { return $false }
+  Write-Step "Upgrading Node via nvm-windows ($NodeMajor) …"
+  nvm install $NodeMajor
+  nvm use $NodeMajor
+  return $true
+}
+
+function Try-WingetNode {
+  $winget = Get-Command winget -ErrorAction SilentlyContinue
+  if (-not $winget) { return $false }
+  Write-Step "Installing Node.js LTS via winget …"
+  winget install --id OpenJS.NodeJS.LTS -e --accept-source-agreements --accept-package-agreements
+  $env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
+  return $true
+}
+
+function Show-ManualHelp {
+  Write-Host ""
+  Write-Host "omnish needs Node.js 22.13 or newer."
+  Write-Host "You have: $(Get-NodeVersionLabel)"
+  Write-Host ""
+  Write-Host "Automatic upgrade failed. Pick one path:"
+  Write-Host ""
+  Write-Host "  nvm-windows (recommended):"
+  Write-Host "    nvm install $NodeMajor"
+  Write-Host "    nvm use $NodeMajor"
+  Write-Host "    npm install -g $OmnishSpec"
+  Write-Host ""
+  Write-Host "  winget:"
+  Write-Host "    winget install OpenJS.NodeJS.LTS"
+  Write-Host "    npm install -g $OmnishSpec"
+  Write-Host ""
+  Write-Host "  Official installer:"
+  Write-Host "    https://nodejs.org/en/download"
+  Write-Host ""
+  Write-Host "  Re-run the guided installer:"
+  Write-Host "    irm $InstallScriptUrl | iex"
+  Write-Host ""
+}
+
+Write-Banner
+Write-Step "Checking Node.js (need 22.13+, you have $(Get-NodeVersionLabel))"
+
+if ((Get-Command omnish -ErrorAction SilentlyContinue) -and (Test-NodeVersionOk)) {
+  Write-Host "omnish is already installed."
+  try { omnish --version } catch {}
+  Write-Host "To upgrade: npm install -g omnish@latest"
+  exit 0
+}
+
+if (Test-NodeVersionOk) {
+  Install-Omnish
+  exit 0
+}
+
+if ((Try-NvmWindows -or Try-WingetNode) -and (Test-NodeVersionOk)) {
+  Install-Omnish
+  exit 0
+}
+
+Show-ManualHelp
+exit 1

package/contrib/install-omnish.sh

@@ -1,12 +1,28 @@
 #!/usr/bin/env bash
-# Bootstrap omnish install: ensure Node 22.13+, then npm install -g omnish.
-# Served from npm (unpkg) — see scripts/node-version.cjs readBootstrapInstallScriptUrl().
+# omnish bootstrap installer — upgrades Node 22.13+ when needed, then npm install -g omnish.
+# Canonical URL: https://platform.omnish.dev/action/install-omnish.sh
 set -euo pipefail
 
 OMNISH_NPM_SPEC="${OMNISH_NPM_SPEC:-omnish}"
 NODE_MAJOR="${OMNISH_NODE_MAJOR:-22}"
 NVM_INSTALL_URL="${NVM_INSTALL_URL:-https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh}"
 
+banner() {
+  cat <<'EOF'
+
+  omnish — allowlisted inbox → your real shell
+  ────────────────────────────────────────────
+  WhatsApp / Telegram / 20+ channels. No AI layer.
+  Commands run on YOUR machine. You control the allowlist.
+
+EOF
+}
+
+step() {
+  echo ""
+  echo "▸ $1"
+}
+
 need() {
   command -v "$1" >/dev/null 2>&1 || {
     echo "error: required command not found: $1" >&2
@@ -36,22 +52,33 @@ current_node() {
 
 install_omnish() {
   need npm
-  echo ""
-  echo "Installing ${OMNISH_NPM_SPEC} with Node $(node -v) …"
+  step "Installing omnish CLI (npm install -g ${OMNISH_NPM_SPEC}) …"
   npm install -g "${OMNISH_NPM_SPEC}"
   echo ""
-  echo "Done. Next steps:"
-  echo "  omnish --version"
-  echo "  omnish link          # WhatsApp QR or --tg for Telegram"
-  echo "  omnish allow +E164   # your phone number"
-  echo "  omnish start"
+  if command -v omnish >/dev/null 2>&1; then
+    echo "✓ omnish $(omnish --version 2>/dev/null || echo 'installed')"
+  else
+    echo "✓ omnish installed (reopen shell if omnish not found)"
+  fi
+  echo ""
+  cat <<'EOF'
+  You're ready. Run these next (≈2 minutes to first command):
+
+    omnish link            Link WhatsApp (QR) or Telegram (--tg <token>)
+    omnish allow +E164     Allow your phone number (shell access = password)
+    omnish start           Run the gateway in the background
+
+  Then message yourself:  !pwd   or   !ls
+
+  Docs: https://omnish.dev · Help: omnish --help
+EOF
 }
 
 ensure_build_deps() {
   if ! is_debian_ubuntu; then
     return 0
   fi
-  echo "Installing build tools for native modules (better-sqlite3, node-pty) …"
+  step "Installing build tools (better-sqlite3, node-pty native modules) …"
   export DEBIAN_FRONTEND=noninteractive
   apt-get update -qq
   apt-get install -y build-essential python3 curl ca-certificates
@@ -68,7 +95,7 @@ load_nvm() {
 
 try_nvm() {
   if load_nvm; then
-    echo "Using nvm to install Node ${NODE_MAJOR} and set default …"
+    step "Upgrading Node via nvm (${NODE_MAJOR}, set as default) …"
     nvm install "${NODE_MAJOR}"
     nvm alias default "${NODE_MAJOR}"
     nvm use default
@@ -79,7 +106,7 @@ try_nvm() {
 
 try_fnm() {
   if command -v fnm >/dev/null 2>&1; then
-    echo "Using fnm to install Node ${NODE_MAJOR} and set default …"
+    step "Upgrading Node via fnm (${NODE_MAJOR}) …"
     fnm install "${NODE_MAJOR}"
     fnm default "${NODE_MAJOR}"
     eval "$(fnm env)"
@@ -88,12 +115,23 @@ try_fnm() {
   return 1
 }
 
+try_homebrew() {
+  if [[ "$(uname -s)" != "Darwin" ]] || ! command -v brew >/dev/null 2>&1; then
+    return 1
+  fi
+  step "Upgrading Node via Homebrew node@${NODE_MAJOR} …"
+  brew install "node@${NODE_MAJOR}"
+  brew link --overwrite --force "node@${NODE_MAJOR}"
+  hash -r || true
+  return 0
+}
+
 try_nodesource() {
   if ! is_debian_ubuntu; then
     return 1
   fi
   need curl
-  echo "Using NodeSource to install Node ${NODE_MAJOR}.x (replaces old apt node) …"
+  step "Upgrading Node via NodeSource ${NODE_MAJOR}.x (replaces old apt node) …"
   curl -fsSL "https://deb.nodesource.com/setup_${NODE_MAJOR}.x" | bash -
   apt-get install -y nodejs
   hash -r 2>/dev/null || true
@@ -102,10 +140,11 @@ try_nodesource() {
 
 install_nvm() {
   need curl
-  echo "nvm not found — installing nvm …"
+  step "Installing nvm, then Node ${NODE_MAJOR} …"
   curl -fsSL "${NVM_INSTALL_URL}" | bash
   load_nvm || {
-    echo "error: nvm install finished but nvm.sh is missing. Open a new shell and re-run this script." >&2
+    echo "error: nvm install finished but nvm.sh is missing. Open a new shell and re-run:" >&2
+    echo "  curl -fsSL https://platform.omnish.dev/action/install-omnish.sh | bash" >&2
     exit 1
   }
   nvm install "${NODE_MAJOR}"
@@ -137,11 +176,22 @@ Automatic upgrade failed. Pick one path:
   Official installers:
     https://nodejs.org/en/download
 
+  Re-run the guided installer anytime:
+    curl -fsSL https://platform.omnish.dev/action/install-omnish.sh | bash
+
 EOF
 }
 
 main() {
-  echo "omnish installer — Node $(current_node) (need 22.13+)"
+  banner
+  step "Checking Node.js (need 22.13+, you have $(current_node))"
+
+  if command -v omnish >/dev/null 2>&1 && command -v node >/dev/null 2>&1 && node_version_ok; then
+    echo "omnish is already installed."
+    omnish --version 2>/dev/null || true
+    echo "To upgrade: npm install -g omnish@latest"
+    exit 0
+  fi
 
   if command -v node >/dev/null 2>&1 && node_version_ok; then
     install_omnish
@@ -157,6 +207,12 @@ main() {
     fi
   fi
 
+  # macOS — Homebrew before nvm when available.
+  if [[ "$(uname -s)" == "Darwin" ]] && try_homebrew && node_version_ok; then
+    install_omnish
+    exit 0
+  fi
+
   if try_nvm || try_fnm; then
     if node_version_ok; then
       install_omnish