@agentxm/client-core 0.4.0 → 0.4.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentxm/client-core",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Core library for the axm agent extension manager",
   "type": "module",
   "license": "MIT",
@@ -209,6 +209,6 @@
     "typescript": "^5.9.3",
     "vitest": "^4.0.0",
     "yaml": "^2.8.2",
-    "@agentxm/client-utils": "0.4.0"
+    "@agentxm/client-utils": "0.4.2"
   }
 }

package/site-content/install.md

@@ -20,29 +20,10 @@ extension packs across your AI agents from a single CLI.
 
 ## Step 1: Install
 
-Choose one installation method. Agents typically run in Node.js environments, so
-npx is the recommended default.
+Each method below installs a persistent `axm` binary on the machine. Pick the
+one that matches the environment (operating system or package manager).
 
-### Option A: npx (recommended for agents)
-
-Requires Node.js. No global install needed.
-
-```bash
-npx axm.sh --version
-```
-
-Prefix all axm commands with `npx axm.sh` instead of `axm`:
-
-```bash
-npx axm.sh auth login
-npx axm.sh whoami
-```
-
-### Option B: Native install scripts
-
-For environments without Node.js. Downloads a standalone binary.
-
-**macOS / Linux (bash):**
+### Option A: macOS / Linux (install script)
 
 ```bash
 curl -fsSL https://axm.sh/install.sh | sh
@@ -54,7 +35,7 @@ Installs to `~/.axm/bin/axm`. If `axm` is not found after install, add to PATH:
 export PATH="$HOME/.axm/bin:$PATH"
 ```
 
-**Windows (PowerShell):**
+### Option B: Windows (PowerShell)
 
 ```powershell
 irm https://axm.sh/install.ps1 | iex
@@ -63,9 +44,7 @@ irm https://axm.sh/install.ps1 | iex
 Installs to `%LOCALAPPDATA%\axm\axm.exe`. Follow the printed PATH instructions
 if `axm` is not recognized.
 
-**Windows (CMD):**
-
-Download and run `install.cmd` from `https://axm.sh/install.cmd`:
+### Option C: Windows (CMD)
 
 ```cmd
 curl -fsSL -o install.cmd https://axm.sh/install.cmd && install.cmd
@@ -74,12 +53,27 @@ curl -fsSL -o install.cmd https://axm.sh/install.cmd && install.cmd
 Installs to `%LOCALAPPDATA%\axm\axm.exe`. Follow the printed PATH instructions
 if `axm` is not recognized.
 
-### Option C: Homebrew (macOS / Linux)
+### Option D: Homebrew (macOS / Linux)
 
 ```bash
 brew install agentxm/tap/axm
 ```
 
+### Option E: npm (any OS with Node.js)
+
+Installs the `axm.sh` package globally. Requires Node.js.
+
+```bash
+npm install -g axm.sh
+```
+
+If `axm` is not found after install, ensure the npm global bin directory is on
+PATH:
+
+```bash
+export PATH="$(npm config get prefix)/bin:$PATH"
+```
+
 **Verify:**
 
 ```bash
@@ -147,7 +141,6 @@ axm skills list --json
 
 The fix depends on how you installed:
 
-- **npx:** Use `npx axm.sh` instead of `axm`. Ensure Node.js is installed.
 - **Install script (macOS/Linux):** Add `~/.axm/bin` to PATH:
   ```bash
   export PATH="$HOME/.axm/bin:$PATH"
@@ -160,7 +153,7 @@ The fix depends on how you installed:
   $env:Path = "$env:LOCALAPPDATA\axm;$env:Path"
   ```
 - **Homebrew:** Run `brew link axm` or check `brew --prefix axm`.
-- **npm (legacy):** Ensure your global npm bin directory is on PATH:
+- **npm:** Ensure the global npm bin directory is on PATH:
   ```bash
   export PATH="$(npm config get prefix)/bin:$PATH"
   ```

package/site-content/install.ps1

@@ -0,0 +1,128 @@
+# Install script for axm — the extension manager for AI coding agents.
+# Usage: irm https://axm.sh/install.ps1 | iex
+$ErrorActionPreference = 'Stop'
+
+$GITHUB_REPO = if ($env:AXM_INSTALL_GITHUB_REPO) { $env:AXM_INSTALL_GITHUB_REPO } else { "agentxm/axm" }
+$BASE_URL = if ($env:AXM_INSTALL_BASE_URL) {
+    $env:AXM_INSTALL_BASE_URL
+}
+else {
+    "https://github.com/$GITHUB_REPO/releases/latest/download"
+}
+
+function Detect-Architecture {
+    $arch = $env:PROCESSOR_ARCHITECTURE
+
+    switch ($arch) {
+        "AMD64" {
+            return "x64"
+        }
+        "ARM64" {
+            Write-Host "Error: Windows arm64 is not yet supported." -ForegroundColor Red
+            exit 1
+        }
+        default {
+            Write-Host "Error: Unsupported architecture: $arch" -ForegroundColor Red
+            Write-Host ""
+            Write-Host "Supported architectures:"
+            Write-Host "  - x64 (AMD64)"
+            exit 1
+        }
+    }
+}
+
+function Download-Binary {
+    param (
+        [string]$Arch
+    )
+
+    $artifact = "axm-windows-${Arch}.exe"
+    $downloadUrl = "$BASE_URL/$artifact"
+    $installDir = Join-Path $env:LOCALAPPDATA "axm"
+    $target = Join-Path $installDir "axm.exe"
+
+    Write-Host "Detected platform: windows-$Arch"
+    Write-Host "Downloading $artifact..."
+
+    if (-not (Test-Path $installDir)) {
+        New-Item -ItemType Directory -Path $installDir -Force | Out-Null
+    }
+
+    $previousProgressPreference = $ProgressPreference
+    $ProgressPreference = 'SilentlyContinue'
+
+    try {
+        Invoke-WebRequest -Uri $downloadUrl -OutFile $target -UseBasicParsing
+    }
+    catch {
+        Write-Host ""
+        Write-Host "Error: Failed to download $artifact." -ForegroundColor Red
+        Write-Host "URL: $downloadUrl"
+        Write-Host ""
+        Write-Host "Check that the release exists and your network connection is working."
+        exit 1
+    }
+    finally {
+        $ProgressPreference = $previousProgressPreference
+    }
+
+    Write-Host "Installed to $target"
+
+    # Write install metadata
+    $metaFile = Join-Path $installDir "install-meta.json"
+    $timestamp = [DateTime]::UtcNow.ToString("yyyy-MM-ddTHH:mm:ssZ")
+    $metaContent = "{`"method`": `"script`", `"installedAt`": `"$timestamp`"}"
+    Set-Content -Path $metaFile -Value $metaContent -Encoding UTF8
+
+    return $installDir
+}
+
+function Test-AxmOnPath {
+    $cmd = Get-Command "axm" -ErrorAction SilentlyContinue
+    return $null -ne $cmd
+}
+
+function Print-PathInstructions {
+    param (
+        [string]$InstallDir
+    )
+
+    Write-Host "Add axm to your PATH:"
+    Write-Host ""
+    Write-Host "  Option 1: Via System Properties"
+    Write-Host "    1. Press Win+R, type 'sysdm.cpl', press Enter"
+    Write-Host "    2. Go to Advanced > Environment Variables"
+    Write-Host "    3. Under User variables, select Path, click Edit"
+    Write-Host "    4. Click New, add: $InstallDir"
+    Write-Host "    5. Click OK to save"
+    Write-Host ""
+    Write-Host "  Option 2: Via PowerShell (current user):"
+    Write-Host "    `$currentPath = [Environment]::GetEnvironmentVariable('Path', 'User')"
+    Write-Host "    [Environment]::SetEnvironmentVariable('Path', `"$InstallDir;`$currentPath`", 'User')"
+}
+
+function Verify {
+    param (
+        [string]$InstallDir
+    )
+
+    Write-Host ""
+
+    if (Test-AxmOnPath) {
+        & axm --version
+        Write-Host ""
+        Write-Host "Done! Run 'axm auth login' to get started."
+    }
+    else {
+        Write-Host "axm was installed to $InstallDir but it is not on your PATH."
+        Write-Host ""
+        Print-PathInstructions -InstallDir $InstallDir
+        Write-Host ""
+        Write-Host "Then open a new terminal and run: axm auth login"
+    }
+}
+
+# Main
+$arch = Detect-Architecture
+$installDir = Download-Binary -Arch $arch
+Verify -InstallDir $installDir