Add Windows Server Node.js installation guide

Author: mattbaylor

INSTALL_WINDOWS_NODEJS.md

@@ -0,0 +1,126 @@
+# OpenCode Installation for Windows Server 2022 (Node.js)
+
+This guide will help you install and run OpenCode with Node.js on Windows Server 2022, avoiding the Bun virtualization issues.
+
+## Prerequisites
+
+1. **Node.js 20+** must be installed
+2. **Git** must be installed  
+3. PowerShell with Administrator access
+
+## Installation Steps
+
+### 1. Clone the Node.js Migration Branch
+
+```powershell
+# Clone the repository and checkout the node-migration branch
+git clone https://github.com/mattbaylor/opencode.git
+cd opencode
+git checkout node-migration
+```
+
+### 2. Install pnpm
+
+```powershell
+npm install -g pnpm
+```
+
+### 3. Install Dependencies
+
+```powershell
+pnpm install
+```
+
+This will install all dependencies for the monorepo.
+
+### 4. Run OpenCode
+
+```powershell
+# Navigate to opencode package
+cd packages\opencode
+
+# Run with tsx (TypeScript executor)
+npx tsx src\index.ts
+
+# Or run from root with pnpm
+cd ..\..
+pnpm --filter opencode exec tsx src/index.ts
+```
+
+## Creating a Convenient Launcher
+
+### Option 1: PowerShell Function
+
+Add this to your PowerShell profile (`notepad $PROFILE`):
+
+```powershell
+function opencode {
+    $OpencodeDir = "C:\path\to\opencode"  # Update this path
+    Push-Location "$OpencodeDir\packages\opencode"
+    npx tsx src\index.ts $args
+    Pop-Location
+}
+```
+
+Then reload your profile: `. $PROFILE`
+
+Now you can run `opencode` from anywhere!
+
+### Option 2: Batch File
+
+Create `C:\Windows\opencode.bat`:
+
+```batch
+@echo off
+cd /d C:\path\to\opencode\packages\opencode
+npx tsx src\index.ts %*
+```
+
+Make sure `C:\Windows` is in your PATH (it usually is).
+
+## Troubleshooting
+
+### If `pnpm install` fails
+
+Make sure you're on the `node-migration` branch:
+```powershell
+git branch
+```
+
+Should show `* node-migration`
+
+### If dependencies fail to install
+
+Try clearing the cache:
+```powershell
+pnpm store prune
+pnpm install --force
+```
+
+### If tsx command not found
+
+Install it globally:
+```powershell
+npm install -g tsx
+```
+
+## Why This Works
+
+- **No Bun dependency**: Completely runs on Node.js
+- **No VM issues**: Node.js doesn't have the memory alignment bugs that Bun has in VMs
+- **No AVX2 requirement**: Node.js works fine without AVX2 instructions
+- **Easy to update**: Just `git pull` and `pnpm install`
+
+## Next Steps
+
+Once you verify it works, you can:
+1. Update to latest changes: `git pull origin node-migration`
+2. Rebuild if needed: `pnpm install`
+3. Customize your configuration in `~/.opencode/`
+
+## Support
+
+The Windows binaries are available at:
+https://github.com/mattbaylor/opencode/releases/tag/windows-baseline-build
+
+(Note: These are Bun-based and will crash in VMs - use this Node.js method instead)