Installation

One command, zero dependencies. 78 statically-linked binaries across Linux, macOS, and Windows — pure C, no runtime required.

78
Static Binaries
5
Platforms
0
Zero Dependencies

⚡ Quick Install

Pick your platform and run a single command. The installer downloads pre-built static binaries from get.scorpiox.net and places them in the system path.

curl -fsSL "https://get.scorpiox.net?platform=linux" | bash

Works on any x86_64 or ARM64 Linux with kernel 3.2+. No root required if /usr/local/bin is writable, otherwise the installer uses sudo.

curl -fsSL "https://get.scorpiox.net?platform=mac" | bash

Apple Silicon (ARM64) and Intel (x86_64). Universal binaries are statically linked — no Homebrew, no Xcode command line tools required.

iwr -useb https://get.scorpiox.net | iex

Run in PowerShell (Admin recommended). Installs 65 native PE binaries to C:\scorpiox\ and adds the directory to PATH.

🖥️ Supported Platforms

🐧

Linux x86_64

ELF static, musl libc, kernel 3.2+

74 binaries

🐧

Linux ARM64

ELF static, musl libc, aarch64

74 binaries

🍎

macOS ARM64

Mach-O, Apple Silicon, macOS 12+

73 binaries

🍎

macOS x86_64

Mach-O, Intel, macOS 12+

73 binaries

🪟

Windows x86_64

PE static, MSVC, Windows 10+

65 binaries

🌐

WebAssembly

WASM32, browser sandbox

2 binaries

🔧 How It Works

The installer is a thin shell script (or PowerShell on Windows) that performs these steps:

Detect architecture

Reads uname -m (Linux/macOS) or processor architecture (Windows) to select the correct binary archive.

Download from get.scorpiox.net

Fetches the platform-specific archive via HTTPS. The URL pattern is https://get.scorpiox.net/scorpiox-<platform>-<arch>.tar.gz.

Extract binaries

Unpacks statically-linked binaries to the install directory: /usr/local/bin (Linux/macOS) or C:\scorpiox\ (Windows).

Initialize configuration

Creates scorpiox-env.txt in the install directory with default settings. No API keys are required to start.

Verify & done

Runs sx --version to confirm the installation. All 78 tools are available immediately.

✅ Verify Installation

After installing, open a new terminal and run:

sx --version

Expected output:

scorpiox-code v1.x.x (commit f314b04) Platform: linux-x64 Binaries: 74 installed

Check individual tools:

# List all installed tools sx --list # Check a specific tool scorpiox-config --help scorpiox-bash --version

⚙️ Post-Install Configuration

Configuration lives in scorpiox-env.txt — a flat key=value file. The installer creates one with defaults. Key settings to configure:

Key Description Default
MODEL AI model to use (opus, sonnet, haiku) sonnet
THINKING Enable extended thinking true
THINKING_BUDGET Max thinking tokens 10000
PERMISSIONS_BASH Bash execution policy ask
PROMPT_INCLUDE_CLAUDEMD Include CLAUDE.md in system prompt true
HOOKS_ENABLED Enable pre/post execution hooks false

Config file locations (checked in order)

# 1. Beside the executables <exe_dir>/scorpiox-env.txt # 2. User home directory ~/.scorpiox/scorpiox-env.txt # 3. Project-level override ./.scorpiox/scorpiox-env.txt

Project-level settings override user-level, which override system-level. Use scorpiox-config to manage settings:

# View current config scorpiox-config --list # Set a value scorpiox-config --set MODEL=opus # Set project-level override scorpiox-config --set THINKING=true --scope project

🔄 Updating

Re-run the install command to update to the latest version. The installer overwrites existing binaries in-place.

Linux / macOS

curl -fsSL "https://get.scorpiox.net?platform=linux" | bash

Windows

iwr -useb https://get.scorpiox.net | iex

Your scorpiox-env.txt configuration is preserved across updates — the installer never overwrites existing config files.

🗑️ Uninstall

Linux / macOS

# Remove all scorpiox binaries sudo rm -f /usr/local/bin/scorpiox-* /usr/local/bin/sx # Remove config (optional) rm -rf ~/.scorpiox/

Windows

# Remove install directory Remove-Item -Recurse -Force C:\scorpiox # Remove from PATH (run as Admin) $path = [Environment]::GetEnvironmentVariable('PATH', 'Machine') $path = ($path.Split(';') | Where-Object { $_ -ne 'C:\scorpiox' }) -join ';' [Environment]::SetEnvironmentVariable('PATH', $path, 'Machine')

🛠️ Troubleshooting

Permission denied during install

On Linux/macOS, the installer needs write access to /usr/local/bin. Run with sudo or install to a user-writable directory by setting INSTALL_DIR.

Command not found after install

Open a new terminal session. On Linux, ensure /usr/local/bin is in your PATH. On Windows, restart PowerShell after installation to pick up the updated PATH.

Proxy or corporate firewall

Set https_proxy (Linux/macOS) or configure system proxy (Windows) before running the installer. The script uses curl/wget/iwr which respect proxy environment variables.

Architecture detection fails

Verify with uname -m (Linux/macOS) — should show x86_64 or aarch64. If running under emulation (Rosetta, QEMU), force the architecture: curl -fsSL "https://get.scorpiox.net?platform=linux&arch=x64" | bash

Antivirus blocks binaries (Windows)

Some antivirus software flags unsigned executables. Add C:\scorpiox\ to your antivirus exclusion list. The binaries are statically compiled from source — no telemetry, no network calls at startup.

Containers / CI environments

The installer works in Docker, Podman, and CI pipelines. For minimal images, download the binary tarball directly:
curl -fsSL https://get.scorpiox.net/scorpiox-linux-x64.tar.gz | tar xz -C /usr/local/bin