<<<<<<< HEAD
Home› Platform Support
=======
← Home › Platform Support
>>>>>>> a6f660b (nav: update feature page links)

Platform Support

8 build targets across Linux, macOS, Windows, WebAssembly, Android, and iOS — all from a single pure-C codebase compiled with CMake.

8Platforms
361Total Binaries
C11Standard
CMakeBuild System

Overview

scorpiox code is a single C11 codebase that compiles to native binaries for 8 platform targets. Linux builds are fully static (musl), macOS uses mostly-static linking, Windows links Win32 system libraries, and WebAssembly runs in any modern browser. Android and iOS produce shared/static libraries for mobile app embedding.

Build Matrix

Platform Arch Compiler Format Static Binaries
🐧 Linux x86_64 gcc (musl-static) ELF ✓ 74
🐧 Linux aarch64 aarch64-linux-gnu-gcc ELF ✓ 74
🍎 macOS aarch64 AppleClang (Xcode) Mach-O ✗ 73
🍎 macOS x86_64 AppleClang (Xcode) Mach-O ✗ 73
🪟 Windows x86_64 MinGW gcc (POSIX UCRT) PE ✓ 65
🌐 Browser wasm32 emcc (Emscripten) WebAssembly ✗ 2
🤖 Android aarch64 NDK clang (r27c) ELF (.so) ✗ 0
📱 iOS aarch64 Xcode clang (iOS SDK) Mach-O (.a) ✓ 0

Build Details by Platform

🐧

Linux x86_64

gcc (musl-static) · ELF · 74 binaries
Min OSAny (fully static musl, no glibc dependency)
StaticYes
Install
curl -fsSL "https://get.scorpiox.net?platform=linux" | bash

Platform Features

  • Containers (scorpiox-unshare, rootless namespaces)
  • KVM virtual machines (scorpiox-vm, x86_64 only)
  • Container init (scorpiox-init, PID 1)
  • Podman/Docker execution
  • PTY/forkpty (libutil)
  • X11 screenshots (scorpiox-screenshot)
  • cgroups
  • Network traffic capture (scorpiox-traffic)
  • resolv (DNS for email server)

Excluded Binaries

scorpiox-busyboxscorpiox-imessagescorpiox-thunderbolt4scorpiox-wsl
🐧

Linux aarch64

aarch64-linux-gnu-gcc · ELF · 74 binaries
Min OSAny (fully static musl binary)
StaticYes
Install
curl -fsSL "https://get.scorpiox.net?platform=linux" | bash

Platform Features

  • Containers (scorpiox-unshare, rootless namespaces)
  • Container init (scorpiox-init, PID 1)
  • Podman/Docker execution
  • PTY/forkpty (libutil)
  • X11 screenshots (scorpiox-screenshot)
  • Network traffic capture (scorpiox-traffic)
  • resolv (DNS for email server)

Excluded Binaries

scorpiox-busyboxscorpiox-imessagescorpiox-thunderbolt4scorpiox-wsl
ℹ️ KVM builds but only functional on x86_64
🍎

macOS aarch64

AppleClang (Xcode) · Mach-O · 73 binaries
Min OSmacOS 14.0 (Sonoma)
StaticNo
Install
curl -fsSL "https://get.scorpiox.net?platform=mac" | bash

Platform Features

  • Thunderbolt 4 file transfer (scorpiox-thunderbolt4)
  • iMessage CLI (scorpiox-imessage)
  • Podman execution
  • CoreGraphics screenshots (scorpiox-screenshot)
  • WhatsApp bridge

Excluded Binaries

scorpiox-busyboxscorpiox-initscorpiox-unsharescorpiox-vmscorpiox-wsl
ℹ️ Mostly-static linking (-Wl,-search_paths_first)
🍎

macOS x86_64

AppleClang (Xcode) · Mach-O · 73 binaries
Min OSmacOS 14.0 (Sonoma)
StaticNo
Install
curl -fsSL "https://get.scorpiox.net?platform=mac" | bash

Platform Features

  • Thunderbolt 4 file transfer (scorpiox-thunderbolt4)
  • iMessage CLI (scorpiox-imessage)
  • Podman execution
  • CoreGraphics screenshots (scorpiox-screenshot)
  • WhatsApp bridge

Excluded Binaries

scorpiox-busyboxscorpiox-initscorpiox-unsharescorpiox-vmscorpiox-wsl
🪟

Windows x86_64

MinGW gcc (POSIX UCRT) · PE · 65 binaries
Min OSWindows 10 (WSL2)
StaticYes
Install
iwr -useb https://get.scorpiox.net | iex

Platform Features

  • WSL2 execution (scorpiox-wsl)
  • BusyBox applet manager (scorpiox-busybox)
  • Windows version resources (.rc VERSIONINFO)
  • GDI32/User32 screenshots (scorpiox-screenshot)
  • WinSock2 networking

Excluded Binaries

scorpiox-cronscorpiox-docsscorpiox-executecurlscorpiox-imessagescorpiox-initscorpiox-podmanscorpiox-runtestscorpiox-sshpassscorpiox-thunderbolt4scorpiox-trafficscorpiox-unsharescorpiox-vmscorpiox-whatsapp

Win32 Libraries

ws2_32wldap32crypt32advapi32bcryptsecur32iphlpapiole32wininetgdi32user32
🌐

Browser wasm32

emcc (Emscripten) · WebAssembly · 2 binaries
Min OSModern browser with WebAssembly + BigInt
StaticNo
Install
Available at wasm.scorpiox.net

Platform Features

  • ASYNCIFY (cooperative multitasking)
  • IDBFS (persistent IndexedDB filesystem)
  • Fetch API bridge (sx_wasm_fetch_bridge)
  • SSE streaming (sx_wasm_fetch_sse_bridge)
  • Virtual terminal (MEMFS + IDBFS)
  • MODULARIZE=1 (ES module output)
  • Browser API key prompt
  • Interactive user prompts

Exported Functions

_main_malloc_free

Runtime Methods

ccallcwrapFScallMaindynCall
🤖

Android aarch64

NDK clang (r27c) · ELF (.so) · 0 binaries
Min OSAndroid 8.0 (API 26)
StaticNo
Install
release_android.ps1 (NDK cross-compile)

Platform Features

  • JNI bridge (sx_jni.c)
  • Android logging (__android_log_print)
  • mbedTLS for TLS
  • ABI: arm64-v8a
📱

iOS aarch64

Xcode clang (iOS SDK) · Mach-O (.a) · 0 binaries
Min OSiOS 17.0
StaticYes
Install
release_ios.ps1 (Xcode cross-compile)

Platform Features

  • Static archive merging (libtool -static)
  • mbedTLS for TLS
  • All engine symbols exported for P/Invoke

Install Commands

## Linux / macOS
curl -fsSL "https://get.scorpiox.net?platform=linux" | bash
curl -fsSL "https://get.scorpiox.net?platform=mac" | bash
## Windows (PowerShell)
iwr -useb https://get.scorpiox.net | iex
## WebAssembly

Try in browser: wasm.scorpiox.net

Build System & Cross-Compilation

CMake Options

OptionDescription
SX_CROSS_ARM64Cross-compile for ARM64/aarch64
SX_STATIC_LINKBuild fully static executables (default ON)
SX_BUILD_DLLBuild sx.dll / libsx.so shared library
SX_BUILD_STATIC_LIBBuild libsx.a static library for iOS
SX_BUILD_TESTSBuild unit tests

Cross-Compilation Toolchains

TargetToolchain
Linux ARM64aarch64-linux-gnu-gcc (CMake SX_CROSS_ARM64)
AndroidNDK clang r27c (android.toolchain.cmake)
iOSXcode iOS clang (CMAKE_OSX_SYSROOT)
WindowsMinGW gcc (x86_64-w64-mingw32)
WebAssemblyEmscripten emcc (release_wasm.ps1)

Vendored Libraries

LibraryPurpose
yyjsonFast JSON parser — pure C99, zero dependencies
mbedTLSLightweight TLS/crypto — replaces OpenSSL for Android/iOS/FRP
stb_image_resize2Image resizing — header-only

Security Hardening

Linux x64 builds include compiler and linker security hardening flags:

Full Binary List

Full list of binaries built for the Linux x64 target (74 executables):

scorpiox-agent scorpiox-askuserpermission scorpiox-askuserquestion scorpiox-bash scorpiox-beam scorpiox-bmp2png scorpiox-claudecode-fetchtoken scorpiox-claudecode-models scorpiox-claudecode-refreshtoken scorpiox-codex-fetchtoken scorpiox-codex-models scorpiox-codex-refreshtoken scorpiox-config scorpiox-conv scorpiox-cron scorpiox-debug scorpiox-dns scorpiox-docs scorpiox-editfile scorpiox-email scorpiox-emit-session scorpiox-executecurl scorpiox-fetch scorpiox-frp scorpiox-gemini-vertex scorpiox-google-claude scorpiox-google-fetchtoken scorpiox-google-gemini scorpiox-google-models scorpiox-googlemaps scorpiox-googleweather scorpiox-grep scorpiox-hook scorpiox-host scorpiox-init scorpiox-kql scorpiox-logger scorpiox-mcp scorpiox-mcp-httpclient scorpiox-mirror-git scorpiox-multiplexer scorpiox-openai scorpiox-otp scorpiox-planmode scorpiox-podman scorpiox-printlogs scorpiox-readfile scorpiox-renderimage scorpiox-rewind scorpiox-runtest scorpiox-screenshot scorpiox-sdk scorpiox-search scorpiox-server scorpiox-server-email scorpiox-server-fetchtoken scorpiox-server-http2tcp scorpiox-skills scorpiox-sshpass scorpiox-systemprompt scorpiox-tasks scorpiox-tmux scorpiox-traffic scorpiox-transcript scorpiox-unshare scorpiox-usage scorpiox-vault-git scorpiox-vertex-models scorpiox-vi scorpiox-vm scorpiox-voice scorpiox-websearch scorpiox-whatsapp sx