Skip to main content
Back

vphone-cli Lets Developers Run a Full Jailbroken iOS 26 VM on Mac

Lakr233 open-sources vphone-cli, a Swift CLI that automates the multi-step process of booting a patched iOS 26 VM on Apple Silicon Macs using Apple's own Virtualization.framework.

Repo, Full Access
  • What: Lakr233 open-sourced vphone-cli, a Swift CLI that automates booting a virtual iOS 26 iPhone on Apple Silicon Macs using Apple's Virtualization.framework.
  • Origin: Built on top of researcher wh1te4ever's writeup showing Apple's PCC research VM infrastructure could be repurposed to run a full iOS instance.
  • Five variants: From Patchless (4 patches) to Experimental (141 patches), with the Jailbreak variant auto-installing Sileo and TrollStore on first boot.
  • Requirements: Apple Silicon Mac, macOS 15+ Sequoia, SIP/AMFI disabled, and Xcode with iOS SDK — not suitable for daily driver machines.
  • AI testing: Exposes a control socket for screenshots, touch, and swipe injection; companion project vphone-mcp wraps it as an MCP server for Claude Code/Desktop.
  • Traction: 4,116 stars and 666 forks on GitHub; MIT-licensed and free, positioning it as a self-hosted alternative to paid services like Corellium.

vphone-cli is an open-source Swift project from developer Lakr233 that has quietly picked up over 4,100 GitHub stars. The repo automates the previously painful, manual process of standing up a virtual iPhone running iOS 26 on an Apple Silicon Mac , something that was theoretically possible but practically out of reach for most people until now.

Where this comes from

The underlying technique was first documented by researcher Hyungyu Seo (wh1te4ever), who showed that Apple's Private Cloud Compute (PCC) research environment could be repurposed to boot a near-hardware-accurate iOS instance. The setup worked, but it required firmware extraction, manual patching, and deep familiarity with Apple's boot chain. Lakr233's contribution is packaging all of that into a reproducible, scriptable CLI workflow.

PCC (Private Cloud Compute) is Apple's server-side AI infrastructure, and as part of its security research program, Apple ships a virtualization environment , vrevm , that lets researchers inspect PCC workloads. That environment uses private methods from Virtualization.framework, and during VM initialization, the hardware model's ISA and PlatformVersion are explicitly specified , the same knobs that make it possible to emulate an iPhone hardware profile.

What the repo actually does

Once the prerequisite SIP/AMFI steps are completed, the CLI handles environment preparation, firmware modification, and restoration inside the virtual machine , producing a bootable iOS 26.1 system running as a virtual iPhone 17,3, accessible through SSH and VNC. Unlike traditional simulators bundled with Xcode, this environment boots the full secure chain, kernel, and system services.