Every feature, backed by code
Organized by use case. Every shipped feature links directly to its implementation in the open-source codebase.
CI/CD Runners
The core scenario: replace bare-metal runners with cloned VMs. Get 2x capacity on the same hardware, with ephemeral runners that reset after each job.
GitHub Actions Runner Template
Built-in template generates a complete runner registration script. Pass repo and token as variables. Supports labels and ephemeral mode.
View source →Clone in 48ms
FileManager.copyItem triggers APFS clonefile(2). Zero-byte delta clones in ~48ms. No disk copy, no image registry required.
View source →Ephemeral Runners
The --ephemeral flag on start automatically destroys the VM when it stops. Perfect for single-use CI runners that guarantee a clean environment.
View source →SSH Provisioning
Wait-for-SSH with configurable timeout, then execute scripts with streaming output. Works with any user-data script format.
View source →Disk-Inject Provisioning
Zero-network provisioning. Injects a LaunchDaemon and script directly into the VM disk image before boot. No SSH, no network required.
View source →MachineIdentifier Regeneration
Each clone gets a unique hardware identifier. Avoids conflicts when multiple clones run on the same host or register with the same CI service.
View source →Disk Snapshots
Save, restore, list, and delete snapshots per VM. Snapshot before installing Xcode, restore if something breaks. Instant rollback.
View source →BuildKite / CircleCI Templates
Runner registration templates for BuildKite and CircleCI. On the roadmap, not yet shipped.
View Roadmap →Remote Desktop
Give every developer a personal macOS desktop in a VM. Built-in template enables Screen Sharing, and the auto-resize display tracks your window size.
Remote Desktop Template
Built-in template generates a script that enables Screen Sharing (VNC) on the guest. One command to create a remote desktop VM.
View source →Metal GPU Acceleration
1-2 Metal GPU-accelerated displays per VM at 1920x1200 resolution. Hardware-accelerated rendering for a responsive desktop experience.
View source →Auto-Resize Display
Display resolution automatically adjusts when you resize the VM window. Requires macOS 14+ on the host.
View source →Audio Output + Microphone
Full audio passthrough including microphone input. Video calls and audio playback work inside the VM.
View source →VirtIO Shared Folders
Mount host directories inside the VM. Share project files, build artifacts, datasets between host and guest without network.
View source →Full Accessibility
VoiceOver labels, hints, and identifiers on every control. Accessibility announcements for state changes. Reduce motion support.
View source →ML Workloads
Run ML training and inference workloads in isolated VMs with Metal GPU performance, shared folders for datasets, and network isolation.
Metal GPU Acceleration
Up to 2 Metal GPU-accelerated displays per VM at 1920x1200. GPU compute is available to guest workloads through the virtualization layer.
View source →Shared Folders for Datasets
Mount host directories in the VM via VirtIO. Load training data from the host filesystem without copying into the VM image.
View source →Isolated Networking
Air-gapped VMs with zero network access. Run untrusted models or experiments in complete network isolation.
View source →OpenClaw AI Template
Built-in template for OpenClaw AI workloads. Generates a provisioning script tailored for ML environments.
View source →DevOps Automation
Full VM lifecycle management. LaunchDaemon services, PID tracking, capacity enforcement, and machine state save/restore.
Full VM Lifecycle
Start, stop, pause, and resume VMs programmatically. Save and restore machine state on macOS 14+ for instant resume.
View source →Per-VM LaunchDaemon Service
Register any VM as a macOS LaunchDaemon. Automatically starts on boot, restarts on failure. Full lifecycle management.
View source →PID File Tracking
Every running VM writes a PID file. Enables safe process management, prevents duplicate starts, and supports external monitoring.
View source →2-VM Capacity Enforcement
Apple limits 2 concurrent macOS VMs per host. Spooktacular enforces this at the API level to prevent capacity errors.
View source →IP Resolution
Resolve VM IP addresses via DHCP leases with ARP fallback. Enables dynamic SSH connections without hardcoded addresses.
View source →IPSW Restore Image Manager
Auto-download the latest compatible macOS restore image. No manual IPSW hunting. Manages a local image library.
View source →Native Guest Provisioning
Native macOS 27 guest provisioning (VZMacGuestProvisioningOptions) creates the admin account and skips Setup Assistant — no OCR, no keyboard driver. Create a VM, install the OS, and provision in one command.
View source →SPICE Clipboard Bridge
Guest Tools companion app syncs the pasteboard between host and guest over a SPICE serial channel — no SSH, no network required.
View source →HTTP API
Control everything over REST. Endpoints for VM lifecycle, IAM, and RBAC; 27 CLI commands; a native SwiftUI GUI.
HTTP REST API
REST endpoints built on Network.framework with Codable request/response types, covering VM lifecycle, IAM, and RBAC. Control VMs from any language or CI system.
View source →27 CLI Commands
Create, clone, start, stop, delete, list, get, set, ip, ssh, exec, snapshot, service, share, serve, and more.
View source →SwiftUI GUI
Native macOS app with NavigationSplitView, inspector panel, and VM creation sheet. Liquid Glass support on macOS 26+.
View source →Menu Bar Extra
Persistent menu bar icon for quick VM status checks and actions without opening the full app.
View source →Full DocC API Reference
Complete API documentation generated from source. Browse types, methods, and articles in the hosted DocC archive.
View API Docs →OCI Registry Push/Pull
Push and pull VM images to/from OCI-compliant container registries. On the roadmap, not yet shipped.
View Roadmap →793 tests
Every feature is tested. Every claim is backed by code. Audit the source yourself.