param(

[switch]$SkipNodeCheck = $false,

[string]$Version = $(if ($env:AETHER_VERSION) { $env:AETHER_VERSION } else { "latest" })

)

$ErrorActionPreference = "Stop"

if ($Version -notmatch '^[0-9A-Za-z.+-]+$') {

throw "Invalid Version: use latest, a dist-tag, or a semver."

}

$cyan = 11 # BrightCyan

$green = 10 # BrightGreen

$dim = 8 # DarkGray

$red_error = 12

$green_ok = 10

function Write-Header($msg) { Write-Host $msg -ForegroundColor $cyan }

function Write-Success($msg) { Write-Host " [ok] " -NoNewline -ForegroundColor $green_ok; Write-Host $msg -ForegroundColor $dim }

function Write-ErrorMsg($msg) { Write-Host " [error] " -NoNewline -ForegroundColor $red_error; Write-Host $msg }

function Write-Info($msg) { Write-Host " $msg" -ForegroundColor $dim }

function Write-Step($msg) { Write-Host "$msg... " -NoNewline -ForegroundColor $dim }

Write-Host ""

Write-Header "Aether Agent - Terminal Coding Agent Installer"

Write-Info "npm release $Version | aethersystems.net"

Write-Host ""

if (-not $SkipNodeCheck) {

Write-Step "Checking Node.js"

$nodePath = Get-Command node -ErrorAction SilentlyContinue

if (-not $nodePath) {

Write-Host ""

Write-ErrorMsg "Node.js not found. Aether Agent needs Node.js >= 24."

Write-Host ""

Write-Info "Install it from https://nodejs.org"

Write-Info " winget install OpenJS.NodeJS.LTS"

Write-Info " or download from https://nodejs.org/en/download"

exit 1

}

$nodeVersion = (node -v) -replace '^v', ''

$nodeMajor = [int]($nodeVersion.Split('.')[0])

Write-Success "Node.js v${nodeVersion}"

if ($nodeMajor -lt 24) {

Write-ErrorMsg "Node.js >= 24 required (found v${nodeVersion}). Please upgrade."

Write-Info "https://nodejs.org/en/download"

exit 1

}

}

Write-Step "Checking npm"

$npmPath = Get-Command npm -ErrorAction SilentlyContinue

if (-not $npmPath) {

Write-Host ""

Write-ErrorMsg "npm not found (it ships with Node.js). Reinstall Node from https://nodejs.org."

exit 1

}

$npmVersion = npm -v 2>$null

Write-Success "npm v${npmVersion}"

$alreadyInstalled = $false

$aetherPath = Get-Command aether -ErrorAction SilentlyContinue

if ($aetherPath) {

$alreadyInstalled = $true

Write-Info "aether-agent already installed - will install $Version."

}

Write-Host ""

if ($alreadyInstalled) {

Write-Step "Updating aether-agent"

} else {

Write-Step "Installing aether-agent"

}

& npm install -g "aether-agents@$Version" --ignore-scripts

if ($LASTEXITCODE -ne 0 -and $LASTEXITCODE -ne $null) {

Write-ErrorMsg "Install failed. Check your network and npm permissions."

Write-Host ""

if ($Version -ne "latest") {

Write-Info "If npm reports 'No matching version found', $Version is not published."

Write-Info "Published versions: npm view aether-agents versions"

}

$userPrefix = Join-Path $env:LOCALAPPDATA "npm"

Write-Info "For EACCES or permission errors, use a per-user prefix:"

Write-Info (' npm install -g "aether-agents@{0}" --ignore-scripts --prefix "{1}"' -f $Version, $userPrefix)

Write-Info ("Then add $userPrefix to your user PATH and reopen PowerShell.")

exit 1

}

$aetherPath = Get-Command aether -ErrorAction SilentlyContinue

if (-not $aetherPath) {

$npmPrefix = (npm config get prefix 2>$null | Select-Object -First 1)

Write-ErrorMsg "aether command not found on PATH after install."

Write-Info "npm global prefix: $npmPrefix"

Write-Info "Add that directory to your user PATH, reopen PowerShell, then run:"

Write-Info " aether --version"

exit 1

}

$aetherVersion = "unknown"

try { $aetherVersion = (aether --version 2>$null) } catch {}

Write-Success "Aether Agent ${aetherVersion} installed!"

Write-Host ""

Write-Header "Ready - hosted first run"

Write-Host ' aether --version'

Write-Host ' aether auth login'

Write-Host ' aether auth status'

Write-Host ' aether models'

Write-Host ' aether agent "explain this repository"'

Write-Host ' aether doctor'

Write-Host ' aether doctor --live'

Write-Info "No browser: aether auth login --no-browser"

Write-Host ""

Write-Header "Optional local Ollama path"

Write-Host ' aether setup --local'

Write-Host ' aether local pull qwen2.5-coder:7b --yes'

Write-Host ' aether agent --local "explain this repository"'

Write-Info "Ollama must be installed and running before the local steps."

Write-Host ""