Skip to content
Get packs

Drive a Virtual iPhone

Install, run and control vphone virtual iPhones on a Mac from the command line

Source Download skill
Repository
Lakr233/vphone-cli
Stars
16,382
Licence
MIT
Files
10 files

What it does

It teaches an AI agent how to set up and operate vphone, a tool that runs a virtual iPhone on an Apple Silicon Mac. Once installed, the agent can check the Launchpad app status, create and start machines, tap, swipe, type and take screenshots in the virtual phone, call guest methods for apps, files, logs and the UI tree, and troubleshoot black screens or boot problems. It is meant to use the vphone-launchpad-cli client rather than lower-level routes.

Great for

  • iOS developers and security researchers who already use vphone on an Apple Silicon Mac
  • Anyone automating tests on a virtual iPhone from Claude Code or another SKILL.md agent

Skip it if

  • Users without an Apple silicon Mac or without vphone installed, because the skill cannot set up the hardware or the app for them
  • Anyone wanting to run it on a real iPhone or on a production device, since it operates a virtual guest and modifies security-sensitive host settings if asked

Try asking

  • “Check whether vphone is ready and list my virtual iPhones”
  • “Start the machine named test-phone and take a screenshot of its home screen”
  • “Install this IPA into my guest using installd and launch it”
  • “Diagnose why my virtual iPhone shows a black screen after booting”
Step-by-step guide: how to use Drive a Virtual iPhoneInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 10 original files, the MIT licence and an attribution note.

    vphone-guest-control.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip vphone-guest-control.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip vphone-guest-control.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Run vphone-launchpad-cli help first; it is the authoritative command reference if versions differ
  • Ask the agent to name the exact machine you want it to use, so it does not create new machines
  • Keep the host API listener on loopback and avoid force actions unless you intend them

What's inside

  • evals/evals.json
  • references/finding-docs.md
  • references/guest-layout.md
  • references/guest-socket.md
  • references/install-faq.md
  • references/install.md
  • references/machines.md
  • references/rpc-methods.md
  • references/troubleshooting.md
  • SKILL.md

Redistributed unmodified from Lakr233/vphone-cli under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.