Install scorpiox code on macOS — one command for Apple Silicon and Intel Macs. 73 native Mach-O binaries, iMessage, Thunderbolt 4, and CoreGraphics support.
Open Terminal and run this single command to install scorpiox code:
$ curl -fsSL "https://get.scorpiox.net?platform=mac" | bash
Downloads the correct Mach-O binary archive for your architecture (arm64 or x86_64) from dist.scorpiox.net, extracts 73 binaries to /usr/local/bin/, creates the config directory at ~/.scorpiox/, and removes Gatekeeper quarantine attributes automatically.
macOS 14.0 (Sonoma) or later. Apple Silicon (M1/M2/M3/M4) or Intel x86_64. Xcode Command Line Tools (installed automatically if missing).
macOS Sonoma or later required for full CoreGraphics screenshot API support. Older versions work with reduced functionality.
Native arm64 binaries for M1/M2/M3/M4. Native x86_64 binaries for Intel Macs. No Rosetta translation needed.
Xcode Command Line Tools for developer libraries. The installer triggers xcode-select --install if missing.
Required to download binaries from dist.scorpiox.net and to connect to AI providers at runtime.
Launch Terminal from Applications → Utilities, or press ⌘ + Space and type "Terminal".
The install script detects your architecture and downloads the correct binaries:
$ curl -fsSL "https://get.scorpiox.net?platform=mac" | bash
The installer runs this automatically, but if you get a "cannot be opened" error:
$ sudo xattr -rd com.apple.quarantine /usr/local/bin/scorpiox-* $ sudo xattr -rd com.apple.quarantine /usr/local/bin/sx
Create the config file with your API key:
# Provider: claude_code, openai, codex, google, vertex
PROVIDER=claude_code
MODEL=sonnet
ANTHROPIC_API_KEY=sk-ant-...
Navigate to any project directory and launch:
$ cd ~/my-project $ sx
After installation, verify everything is working:
$ sx --version scorpiox-code v2.x.x (macos-arm64) $ file $(which sx) /usr/local/bin/sx: Mach-O 64-bit executable arm64 $ arch arm64 $ ls /usr/local/bin/scorpiox-* | wc -l 72
scorpiox code reads configuration from scorpiox-env.txt. Set up your provider:
<exe_dir>/scorpiox-env.txt → ~/.scorpiox/scorpiox-env.txt → ./.scorpiox/scorpiox-env.txt
| Key | Description | Example |
|---|---|---|
| PROVIDER | AI backend to use | claude_code |
| MODEL | Model tier | sonnet, opus, haiku |
| ANTHROPIC_API_KEY | Anthropic API key | sk-ant-... |
| THINKING | Enable extended thinking | true |
| THINKING_BUDGET | Max thinking tokens | 10000 |
| PERMISSIONS_BASH | Bash execution mode | allow / ask / deny |
| PROMPT_INCLUDE_TREE | Include file tree in prompt | true |
| MCP | Enable MCP protocol | true |
| TMUX_MODE | Container backend | podman / none |
| IMSG_DB_PATH | iMessage database path (macOS only) | ~/Library/Messages/chat.db |
scorpiox-imessage reads and sends iMessages programmatically via the macOS Messages database. Chat history search, automated replies, and message forwarding.scorpiox-thunderbolt4 enables high-speed peer-to-peer file transfer over Thunderbolt 4 connections between Macs.scorpiox-screenshot uses the CGWindowListCreateImage API for zero-dependency screen captures. Requires macOS 14.0+.scorpiox-podman manages rootless containers through podman machine on macOS. Full container lifecycle for isolated dev environments.forkpty() from libutil for interactive CLI sessions, shell wrapping, and terminal multiplexing.scorpiox-whatsapp bridges WhatsApp Web sessions for message automation and AI-powered replies.scorpiox-traffic captures and analyzes network requests for debugging API calls and provider connections.scorpiox-otp generates TOTP/HOTP codes for two-factor authentication without third-party apps.All binaries are native Mach-O executables compiled with AppleClang. Mostly-static linking (-Wl,-search_paths_first) — macOS does not support fully static binaries.
Excluded on macOS (5): scorpiox-busybox, scorpiox-init, scorpiox-unshare, scorpiox-vm, scorpiox-wsl — these require Linux-specific APIs (user namespaces, KVM, BusyBox, WSL).
macOS Gatekeeper may block unsigned binaries downloaded from the internet. The installer clears quarantine flags automatically, but if you see "cannot be opened because the developer cannot be verified":
$ sudo xattr -rd com.apple.quarantine /usr/local/bin/scorpiox-* $ sudo xattr -rd com.apple.quarantine /usr/local/bin/sx
Alternatively, right-click the binary in Finder → Open to add a per-binary exception.
scorpiox code provides native arm64 binaries — Rosetta 2 is not required. If you're running under Rosetta (check with arch), the installer downloads x86_64 binaries instead. For best performance on Apple Silicon, ensure your Terminal is not set to "Open using Rosetta" in Get Info.
Some binaries link against system libraries that require Xcode Command Line Tools. If you see dyld: Library not loaded errors:
$ xcode-select --install
If sx is not found after installation, ensure /usr/local/bin is in your PATH:
$ echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc $ source ~/.zshrc
To remove scorpiox code completely:
# Remove all binaries $ sudo rm -f /usr/local/bin/scorpiox-* /usr/local/bin/sx # Remove config directory (optional — keeps your settings) $ rm -rf ~/.scorpiox