macOS ARM64 Platform Guide

73 Mach-O binaries built natively with AppleClang for Apple Silicon — Thunderbolt 4 file transfer, iMessage CLI, CoreGraphics screenshots, and full macOS integration.

Binaries

Mach-O

Format

aarch64

Architecture

AppleClang

Compiler

Installation

Install scorpiox code on macOS ARM64 (Apple Silicon) with one command:

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

Requires macOS 14.0+ (Sonoma or later) for screenshot API support. Xcode Command Line Tools are used at build time but not required at runtime. Binaries are downloaded from dist.scorpiox.net.

Platform Features

macOS ARM64 includes exclusive Apple platform integrations not available on Linux or Windows:

⚡

Thunderbolt 4 (scorpiox-thunderbolt4)

Peer-to-peer file transfer over Thunderbolt 4 cable between two Macs — zero network, maximum throughput.

💬

iMessage CLI (scorpiox-imessage)

Send and receive iMessages directly from the terminal. Query conversations, send attachments, and automate messaging.

🖥️

CoreGraphics Screenshots (scorpiox-screenshot)

Native macOS screen capture via CoreGraphics API — no X11 required. Supports retina displays and multi-monitor setups.

🐳

Podman Containers (scorpiox-podman)

Run containerized workloads via podman on macOS — rootless execution with full filesystem and network isolation.

📱

WhatsApp Bridge (scorpiox-whatsapp)

Bridge WhatsApp messaging into the CLI for notifications, automated replies, and message forwarding.

Included Binaries

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-imessage 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-thunderbolt4 scorpiox-tmux scorpiox-traffic scorpiox-transcript scorpiox-usage scorpiox-vault-git scorpiox-vertex-models scorpiox-vi scorpiox-voice scorpiox-websearch scorpiox-whatsapp sx

Excluded (not available on macOS)

scorpiox-busybox scorpiox-init scorpiox-unshare scorpiox-vm scorpiox-wsl

Build Details

Property	Value
Operating System	macOS 14.0+ (Sonoma)
Architecture	aarch64 (ARM64 / Apple Silicon)
Compiler	`AppleClang` (Xcode Command Line Tools)
Binary Format	Mach-O 64-bit arm64
Build System	`CMake 3.16+` (C11 standard)
Static Linking	Mostly-static (`-Wl,-search_paths_first`)
Build Script	`release_macos_native.sh`
Shared Library	`scorpiox-server.dylib`
Vendor Libraries	`yyjson`, `mbedtls`, `stb_image_resize2`
Internal Libraries	`libsxutil`, `libsxnet`, `libsxhttp`, `libsxui`, `libsxterm`, `libsxbridge`

Linking Model

macOS does not support fully static binaries. Scorpiox Code uses mostly-static linking with -Wl,-search_paths_first to minimize dynamic dependencies while relying on system frameworks.

The shared library for server P/Invoke:

scorpiox-server.dylib

Configuration

Scorpiox Code reads configuration from scorpiox-env.txt. macOS-specific settings for Thunderbolt, iMessage, and screenshot support:

# macOS ARM64 platform settings in scorpiox-env.txt

# Thunderbolt 4 file transfer
SX_THUNDERBOLT_ENABLED=true
SX_THUNDERBOLT_PEER=auto

# iMessage integration
SX_IMESSAGE_ENABLED=true
SX_IMESSAGE_DB=~/Library/Messages/chat.db

# Screenshot via CoreGraphics
SX_SCREENSHOT_BACKEND=coregraphics

# Podman container runtime
SX_CONTAINER_RUNTIME=podman

# WhatsApp bridge
SX_WHATSAPP_ENABLED=false
SX_WHATSAPP_BRIDGE_PATH=~/.scorpiox/bridges/whatsapp

# macOS Keychain for API keys
SX_KEYCHAIN_ENABLED=true