One command. 65 statically-linked PE binaries. Installs to %LOCALAPPDATA%\scorpiox — no admin required, no registry changes, no dependencies.
Open PowerShell and run:
iwr -useb https://get.scorpiox.net | iex
No admin privileges required. Installs to %LOCALAPPDATA%\scorpiox and adds itself to your user PATH. Open a new terminal after install.
dist.scorpiox.net and get.scorpiox.netscorpiox-wsl container modeAll binaries are statically linked — no Visual C++ Redistributable, no .NET runtime, no DLL dependencies. Built with MinGW gcc (WinLibs POSIX UCRT).
The install script (install_win.ps1) performs 7 steps:
Creates %LOCALAPPDATA%\scorpiox if it doesn't exist.
Fetches scorpiox_code_windows.zip (~18 MB) from dist.scorpiox.net. Branch is auto-detected from index.txt.
SHA256 checksum verification, then extracts all binaries to the install directory.
The main orchestrator binary — downloaded separately with its own SHA256 check.
Adds %LOCALAPPDATA%\scorpiox to your user PATH (no admin needed). Takes effect in new terminal sessions.
Generates scorpiox-update.ps1 and .cmd wrapper for one-command updates.
Generates scorpiox-uninstall.ps1 and .cmd wrapper for clean removal.
65 PE executables included on Windows:
These binaries require Linux-specific APIs (namespaces, cgroups, forkpty) and are not available on Windows:
scorpiox-server-dll (scorpiox-server.dll)scorpiox-email-dll (scorpiox-email.dll)After installation, create a config file at one of these locations (searched in order):
# Option 1: Next to binaries (per-machine)
%LOCALAPPDATA%\scorpiox\scorpiox-env.txt
# Option 2: User home (per-user)
%USERPROFILE%\.scorpiox\scorpiox-env.txt
# Option 3: Project directory (per-project)
.scorpiox\scorpiox-env.txtMinimal config to get started:
# scorpiox-env.txt — minimal Windows setup
PROVIDER=anthropic
ANTHROPIC_API_KEY=sk-ant-...
MODEL=sonnetConfig uses flat KEY=value format. No YAML, no TOML. Parsed in C with zero dependencies. See full configuration reference for all 200+ keys.
scorpiox-wsl is a Windows-exclusive binary that spawns isolated Linux containers inside WSL2. This gives you native Linux tools (git, curl, build toolchains) from a Windows host.
# Launch WSL container
scorpiox-wsl
# With volume mount
TMUX_WSL_VOLUME_MOUNT=C:\Projects:/workspace
# Extra WSL arguments
TMUX_WSL_EXTRA_ARGS=--distribution UbuntuWSL2 must be enabled on your system. Run wsl --install from an admin PowerShell if you haven't already. Minimum: Windows 10 version 2004 (Build 19041).
Both commands are created during installation:
# Update to latest version
scorpiox-update
# Or run the PowerShell script directly
powershell -ExecutionPolicy Bypass -File "%LOCALAPPDATA%\scorpiox\scorpiox-update.ps1"
# Uninstall everything
scorpiox-uninstall
# What gets removed:
# - All binaries in %LOCALAPPDATA%\scorpiox
# - PATH entry
# - Optionally: user data in %USERPROFILE%\.scorpiox| Problem | Solution |
|---|---|
sx not found after install |
Open a new PowerShell window. PATH changes only apply to new sessions. |
| Execution policy error | Run Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned |
| SHA256 checksum mismatch | Re-run the install command. If persistent, check proxy/firewall isn't modifying the download. |
| Download fails / timeout | Check access to dist.scorpiox.net and get.scorpiox.net. Corporate proxies may require config. |
| WSL not available | Run wsl --install from admin PowerShell, reboot, then retry. |
| Antivirus blocking binaries | Add %LOCALAPPDATA%\scorpiox to your AV exclusion list. All binaries are unsigned open-source builds. |