Repo brief: Lakr233/vphone-cli

Generated by RepoPilot · document generated 2026-09-16 · concise human review Evidence snapshot · analyzed 2026-09-16T20:23:35.494Z · commit 339719f34df8

Verdict

Healthy — Healthy across all four use cases

• Last commit 4d ago
• 8 active contributors
• MIT licensed
• CI configured
• 1 more receipt on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against dependency CVEs from deps.dev and OpenSSF Scorecard

What it is

vphone-cli is a command-line tool that boots a fully-patched virtual iPhone on Apple Silicon Macs using Apple's Virtualization.framework. It automates the end-to-end pipeline of downloading iOS firmware, applying kernel/bootloader patches (jailbreak infrastructure), performing DFU restoration, and installing custom firmware—enabling researchers and developers to run instrumented iOS instances locally. Monolithic CLI application: the Swift Package (Package.swift) defines a single vphone-cli binary target that orchestrates Python-based workflows (requirements.txt dependencies like pyimg4, ipsw-parser, pymobiledevice3) for firmware prep/patching and shell scripts (scripts/setup_tools.sh,…

Start here

Read these in order:

• scripts/patchers/cfw_asm.py — Foundation: doesn't import anything internally and is imported by 14 other files. Read first to learn the vocabulary.
• scripts/patchers/cfw_dsc_chunks.py — Foundation: imported by 7, no internal dependencies of its own.
• scripts/patchers/cfw_patch_xpc_lwcr.py — Built on the foundation; imported by 2 downstream files.
• scripts/patchers/cfw_patch_cache_loader.py — Built on the foundation; imported by 2 downstream files.
• scripts/patchers/cfw_patch_lockdown_mode.py — Layer 2 — application-level code that wires the lower layers together.

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

Clone with submodules, then run the setup and build scripts:

git clone --recurse-submodules https://github.com/Lakr233/vphone-cli.git
cd vphone-cli
./scripts/setup_tools.sh
./scripts/build.sh
cd .build/vphone-cli.app/Contents/MacOS/
./vphone-cli --help

Prerequisites: macOS 15+, Apple Silicon, Xcode, and brew-installed dependencies (python@3.13, aria2, wget, gnu-tar, openssl@3, ldid-procursus, sshpass, keystone, cmake, libusb, ipsw, zstd). SIP/AMFI relaxation is requir…

Daily commands:

After build, interact with the VM lifecycle:

# Create a full VM (downloads, patches, restores):
vphone-cli vm create myphone -V jb

# Or step-by-step:
vphone-cli vm new myphone
vphone-cli fw prepare myphone --iphone-version 26.1
vphone-cli fw patch myphone --variant jb
vphone-cli vm launch myphone --dfu &
vphone-cli restore myphone

…shortened for this brief.

Key cautions & unknowns

• Concentrated ownership — top contributor handles 78% of recent commits
• Scorecard: default branch unprotected (0/10)
• Environment: SIP/AMFI relaxation is a one-way host modification required for private PV=3 entitlements (cannot be easily reverted); this is a security/stability tradeoff documented only in the README.…
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests
• OpenSSF Scorecard

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.