omnish 2.1.9 → 2.2.1

package/CHANGELOG.md

@@ -7,6 +7,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.2.1] - 2026-07-11
+
+### Fixed
+
+- **Platform attached reply loop:** stop echoing `reply_error` deliveries back to the same peer (prevented CPU/log storms when Omnish Chat client disconnects).
+- **Tunnel relay:** cooldown drops outbound replies for disconnected `ochat:` peers; normalize `ochat:ochat:` peer keys.
+- **Omnishchat allowlist:** strip `ochat:` prefix from stored install ids so lifecycle broadcasts do not double-prefix peer keys.
+
+## [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
@@ -112,6 +132,7 @@ 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

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,18 +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
 
-**Recommended — one command (works on old Node, VPS, macOS, Linux):**
+Use the **guided installer** — it upgrades Node when needed and runs `npm install -g omnish`. Pick your OS:
 
-```bash
-curl -fsSL https://platform.omnish.dev/action/install-omnish.sh | bash
-```
+| 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                                    |
 
-The installer upgrades Node when needed, installs build tools on Debian/Ubuntu, runs `npm install -g omnish`, and prints your next steps (`link` → `allow` → `start` → first `!` command).
+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
@@ -126,7 +141,7 @@ omnish allow +YOUR_E164
 omnish run
 ```
 
-`npm install -g omnish` on Node below 22.13 will fail by design — use the installer above instead (do not fight `EBADENGINE` warnings on distro Node 12).
+`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

@@ -115,6 +115,17 @@ 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
@@ -196,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