vphone-cli is a Swift command-line tool for creating and running a virtual iPhone on Apple Silicon Macs using Apple's Virtualization.framework and a research VM workflow.
This repository provides a CLI for booting a virtual iPhone and managing its lifecycle on supported Macs. The README shows it can download firmware, patch the boot chain, restore the device in DFU mode, install custom firmware, and launch the VM, while also exposing commands for listing, cloning, exporting, importing, renaming, and deleting VMs.
It addresses the need to set up and operate an iPhone-like virtual environment on a Mac without doing every step manually. Instead of separately handling firmware preparation, restoration, booting, and post-restore setup, the tool packages these stages into repeatable commands for research and experimentation.
At a high level, vphone-cli coordinates Apple’s Virtualization.framework with a research-oriented VM infrastructure to bring up a guest iPhone environment. The README indicates a pipeline that prepares firmware assets, applies variant-specific patches to the boot chain, performs DFU restore, installs custom firmware when needed, and then launches the virtual machine; it also supports different security-bypass variants ranging from a minimal patch set to a jailbreak-oriented and anti-VM-detection configuration.
It appears to be attracting attention because it sits at the intersection of Apple Silicon virtualization, iPhone firmware research, and jailbreak-oriented experimentation. The README emphasizes a one-command end-to-end VM creation flow, multiple patch variants, and tested support across several host and guest firmware combinations, which suggests it is useful to people exploring iOS virtualization and security research.
The README itself does not name direct competitors. Based on what is described, the closest comparable approaches would be manual Virtualization.framework-based setups on Apple Silicon, or other iPhone/iOS research workflows that involve IPSW preparation, DFU restore, and custom firmware installation, but no specific alternative projects are listed here.
AI-explained · grounded in each repo's README