macOS ARM64 Platform Guide

Overview

Scorpiox Code ships 51 native Mach-O binaries for macOS ARM64 (Apple Silicon). All executables are compiled with Apple Clang from Xcode Command Line Tools using the C11 standard. macOS does not support fully static binaries — linking uses -Wl,-search_paths_first to prefer static libraries where available, with libSystem (Apple) as the system libc.

Installation

Install on macOS Apple Silicon with a single command:

Terminal

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

Verify installation:

Terminal

$ sx --version
scorpiox-code v2.x.x (macos-arm64)

$ file $(which sx)
/usr/local/bin/sx: Mach-O 64-bit executable arm64

$ arch
arm64

Platform-Specific Features

💬

iMessage Integration — scorpiox-imessage sends and reads iMessages via the Messages.app AppleScript bridge. macOS-exclusive.
⚡

Thunderbolt 4 Device Info — scorpiox-thunderbolt4 enumerates Thunderbolt 4 devices via IOKit. Reports bus speed, link width, and connected peripherals.
📸

CoreGraphics Screenshots — scorpiox-screenshot uses the CGWindowListCreateImage API for zero-dependency screen captures. Requires macOS 14.0+.
🐳

Podman Containers — scorpiox-podman manages rootless containers through podman machine on macOS. Full container lifecycle support.
🔐

PTY Support — Full pseudo-terminal support for interactive CLI sessions via forkpty() from libutil.
🔑

SSH Pass-through — scorpiox-sshpass provides non-interactive SSH authentication for automated workflows.
🌐

Network Traffic Monitoring — scorpiox-traffic captures and analyzes network traffic on macOS interfaces using BPF.
⏰

Cron Scheduling — scorpiox-cron manages recurring tasks with crontab-compatible scheduling syntax.
📱

WhatsApp CLI — scorpiox-whatsapp sends messages and media through WhatsApp Web bridge integration.

Build Details

Compiler	Apple Clang (Xcode Command Line Tools)
Binary Format	Mach-O 64-bit executable arm64
C Standard	C11
Static Linking	Partial — `-Wl,-search_paths_first` (macOS does not support fully static binaries)
System libc	libSystem (Apple)
Build Script	`release_macos_native.sh`
Build Dependencies	Xcode Command Line Tools, Homebrew cmake
Minimum macOS	macOS 12+ (general), macOS 14.0+ (scorpiox-screenshot)

Included Binaries (51)

scorpiox-agent

scorpiox-askuserquestion

scorpiox-bash

scorpiox-beam

scorpiox-claudecode-fetchtoken

scorpiox-codex-fetchtoken

scorpiox-config

scorpiox-conv

scorpiox-cron

scorpiox-debug

scorpiox-dns

scorpiox-docs

scorpiox-email

scorpiox-emit-session

scorpiox-executecurl

scorpiox-frp

scorpiox-gemini

scorpiox-hook

scorpiox-host

scorpiox-imessage

scorpiox-logger

scorpiox-mcp

scorpiox-mirror-git

scorpiox-multiplexer

scorpiox-openai

scorpiox-otp

scorpiox-planmode

scorpiox-podman

scorpiox-printlogs

scorpiox-pwsh

scorpiox-renderimage

scorpiox-rewind

scorpiox-runtest

scorpiox-screenshot

scorpiox-sdk

scorpiox-search

scorpiox-server

scorpiox-server-email

scorpiox-spaceship-cli

scorpiox-sshpass

scorpiox-systemprompt

scorpiox-tasks

scorpiox-thunderbolt4

scorpiox-tmux

scorpiox-traffic

scorpiox-transcript

scorpiox-usage

scorpiox-vault-git

scorpiox-voice

scorpiox-whatsapp

sx

Excluded Binaries

These binaries are not available on macOS ARM64 due to platform limitations:

scorpiox-busybox

scorpiox-init

scorpiox-unshare

scorpiox-vm

scorpiox-wsl

scorpiox-busybox — Linux-only embedded shell utilities.
scorpiox-init — Linux init system (systemd/SysV integration).
scorpiox-unshare — Linux user namespaces for rootless isolation.
scorpiox-vm — KVM-based virtual machines (Linux kernel only).
scorpiox-wsl — Windows Subsystem for Linux bridge.

Configuration

After installation, configure Scorpiox Code via scorpiox-env.txt in your project root or ~/.scorpiox/:

scorpiox-env.txt

# Provider configuration
SCORPIOX_PROVIDER=anthropic
SCORPIOX_API_KEY=sk-ant-...

# Model selection
SCORPIOX_MODEL=claude-sonnet-4-20250514

# macOS-specific: enable iMessage tool
SCORPIOX_TOOL_IMESSAGE=1

# macOS-specific: enable Thunderbolt 4 detection
SCORPIOX_TOOL_THUNDERBOLT4=1

# Screenshot backend (CoreGraphics on macOS)
SCORPIOX_SCREENSHOT_BACKEND=coregraphics

# Container runtime
SCORPIOX_CONTAINER_RUNTIME=podman

Troubleshooting

⚠️ Gatekeeper Block

macOS Gatekeeper may block unsigned binaries downloaded from the internet. Remove the quarantine attribute:

Terminal

# Remove quarantine flag from all scorpiox binaries
xattr -dr com.apple.quarantine /usr/local/bin/scorpiox-*
xattr -dr com.apple.quarantine /usr/local/bin/sx

⚠️ Rosetta vs Native

Scorpiox Code ships native ARM64 binaries. If file $(which sx) shows x86_64 instead of arm64, you may have installed the Intel version. Reinstall with the Mac installer to get native Apple Silicon binaries:

Terminal

# Force reinstall for native arm64
curl -fsSL "get.scorpiox.net?platform=mac" | bash

⚠️ Xcode Command Line Tools

If building from source, ensure Xcode Command Line Tools and Homebrew cmake are installed:

Terminal

xcode-select --install
brew install cmake