Apple Crash Log .NET Symbolication
dotnet/skills
Resolves .NET runtime frames in Apple .ips crash logs to function names, source files and line numbers using dSYM symbols, atos and the Microsoft symbol server.
Drives a virtual iPhone running on an Apple Silicon Mac through the vphone-launchpad-cli, from checking host setup and starting a machine to tapping, typing and installing apps in the guest.
Install VPhone Guest Control
$ npx skills add Lakr233/vphone-cli --skill vphone-guest-control -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Lakr233/vphone-cli vphone-guest-control --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/Lakr233/vphone-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/Skills/vphone-guest-control .claude/skills/vphone-guest-control && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "vphone-guest-control" agent skill from https://github.com/Lakr233/vphone-cli/tree/main/Skills/vphone-guest-control into .claude/skills/vphone-guest-control/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "vphone-guest-control", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/Lakr233/vphone-cli/tree/main/Skills/vphone-guest-controlType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add Lakr233/vphone-cli --skill vphone-guest-control -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Lakr233/vphone-cli vphone-guest-control --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Lakr233/vphone-cli.git skills-src && mkdir -p .agents/skills && cp -r skills-src/Skills/vphone-guest-control .agents/skills/vphone-guest-control && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "vphone-guest-control" agent skill from https://github.com/Lakr233/vphone-cli/tree/main/Skills/vphone-guest-control into .agents/skills/vphone-guest-control/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "vphone-guest-control", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Lakr233/vphone-cli --skill vphone-guest-control -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Lakr233/vphone-cli vphone-guest-control --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Lakr233/vphone-cli.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/Skills/vphone-guest-control .cursor/skills/vphone-guest-control && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "vphone-guest-control" agent skill from https://github.com/Lakr233/vphone-cli/tree/main/Skills/vphone-guest-control into .cursor/skills/vphone-guest-control/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "vphone-guest-control", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/Lakr233/vphone-cli.git --path Skills/vphone-guest-control--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add Lakr233/vphone-cli --skill vphone-guest-control -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Lakr233/vphone-cli vphone-guest-control --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Lakr233/vphone-cli.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/Skills/vphone-guest-control .gemini/skills/vphone-guest-control && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "vphone-guest-control" agent skill from https://github.com/Lakr233/vphone-cli/tree/main/Skills/vphone-guest-control into .gemini/skills/vphone-guest-control/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "vphone-guest-control", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install Lakr233/vphone-cli vphone-guest-controlInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add Lakr233/vphone-cli --skill vphone-guest-control -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Lakr233/vphone-cli.git skills-src && mkdir -p .github/skills && cp -r skills-src/Skills/vphone-guest-control .github/skills/vphone-guest-control && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "vphone-guest-control" agent skill from https://github.com/Lakr233/vphone-cli/tree/main/Skills/vphone-guest-control into .github/skills/vphone-guest-control/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "vphone-guest-control", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Lakr233/vphone-cli --skill vphone-guest-control -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Lakr233/vphone-cli vphone-guest-control --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Lakr233/vphone-cli.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/Skills/vphone-guest-control .opencode/skills/vphone-guest-control && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "vphone-guest-control" agent skill from https://github.com/Lakr233/vphone-cli/tree/main/Skills/vphone-guest-control into .opencode/skills/vphone-guest-control/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "vphone-guest-control", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
vphone-guest-control- GitHub stars
- 15k
- Token cost
- ~1.6k tokens
- SKILL.md length
- 727 words
- Files
- 10 (incl. references)
- Skills in repo
- 3
- Repo updated
- First seen
- Licence
- MIT
At a glance
Drives a virtual iPhone running on an Apple Silicon Mac through the vphone-launchpad-cli, from checking host setup and starting a machine to tapping, typing and installing apps in the guest.
- Works in 3 steps: Find out where the user is. Run… → Pick the reference for the task, and… → Verify with the guest, not with…
- Setting up vphone and creating a new virtual iPhone machine
- SKILL.md covers How a session should go, Output and errors and Rules that save the user's…
- Calls bundle and xcrun
What it does
vphone runs a virtual iPhone through Apple's Virtualization.framework, with the vphone-launchpad Mac app owning the only privileged helper and downloading or verifying the VPhone.bundle, while vphone-launchpad-cli is a stateless client whose commands also show up in the app's own window and history. The skill insists on using the CLI for everything, since any other route, such as sudo, a separate vphone-cli copy, or devicectl, either lacks the right entitlements, bypasses checks the app records, or times out against these guests.
A session starts by running the CLI's status command: if it does not exist, the agent is pointed to the install reference; otherwise the JSON result decides the next step, such as telling the user to finish host setup in the app themselves when the helper is not ready, installing or verifying a bundle, creating a machine when none exists, or starting and controlling the one the user named. Separate reference files cover installation and its FAQ, creating and managing machines, the guest socket for taps, swipes, keys and screenshots, calling vphoned RPC methods for apps, files, logs, processes and the UI tree, and installing an IPA, a jailbreak bootstrap, or a .deb package.
When your agent uses it
- Setting up vphone and creating a new virtual iPhone machine
- Installing an IPA or a jailbreak bootstrap into a running vphone guest
- Automating taps, swipes or screenshots inside a vphone guest
- Debugging a vphone guest that shows a black screen or won't boot
Example prompts
- “Set up vphone and create my first virtual iPhone machine.”
- “Install this IPA into the running vphone guest.”
- “The vphone guest is stuck on a black screen, help me debug it.”
Requirements
- An Apple Silicon Mac
- vphone-launchpad and vphone-launchpad-cli installed
Workflow steps
3 steps, taken from the first numbered list in SKILL.md.
- Find out where the user is. Run vphone-launchpad-cli status. If the
- Pick the reference for the task, and read it before acting.
- Verify with the guest, not with assumptions. After an input, take a
What it can do on your machine
Read from SKILL.md and the folder at commit 2032dff. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
bundlexcrun
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
VPhone Guest Control loads about 1.6k tokens when it runs, and up to ~16k if it reads all its reference files. Until then it costs about 202 tokens; SKILL.md has 727 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from Lakr233/vphone-cli at commit 2032dff, republished under its MIT licence (© Lakr233). 727 words, ~1,603 tokens.
Download SKILL.mdSave it as
.claude/skills/vphone-guest-control/SKILL.md (or your agent's skills folder). This skill also uses 9 other files; get the full folder from GitHub.- name
- vphone-guest-control
- description
- Install vphone-launchpad and VPhone.bundle, create and run vphone virtual iPhones, and drive a running guest from the command line with vphone-launchpad-cli and the per-machine vphone.sock. Make sure to use this skill whenever the user mentions vphone, vphone-launchpad, vphone-launchpad-cli, VPhone.bundle, vphoned, vphone.sock, or a virtual iPhone on their Mac, even if they do not name the tool. That includes setting vphone up, creating/starting/stopping a machine, tapping/swiping/typing/taking screenshots in the guest, calling a vphoned method (apps, files, logs, processes, UI tree), installing an IPA into a guest, installing the roothide/rootless bootstrap (Irisin), ssh into a guest, installing a .deb, or debugging a guest that shows a black screen or will not boot to the UI.
Driving vphone
vphone runs a virtual iPhone on an Apple Silicon Mac through Virtualization.framework. Two pieces matter to you:
| Piece | Role |
|---|---|
vphone-launchpad (Mac app) | Downloads and verifies VPhone.bundle, creates machines, runs them. Owns the only root helper. |
vphone-launchpad-cli | A stateless client of the running app. Every command also appears in the app's window and history. |
Use vphone-launchpad-cli for everything. The app does the privileged and
signed work for you; a second route (sudo, a copy of vphone-cli, devicectl)
either lacks the entitlements, bypasses the checks the app records, or times out
against these guests.
How a session should go
Find out where the user is. Run
vphone-launchpad-cli status. If the command does not exist, go to install. Otherwise the JSON tells you the next step:canInstallBundles: falseorhelpernotready: the user must finish Host Setup in the app (administrator password, Developer Tools access). You cannot do this for them; say exactly what is missing.defaultBundle: nullorbundleReady: false: install or verify a bundle. Each machine runs with its own bundle (vm list→bundle); the default only decides what new machines get.machines: 0: create one (machines).- Otherwise: list machines, start the one the user named, then control it.
Pick the reference for the task, and read it before acting.
Task Read Install Launchpad or a bundle, host requirements, series matching references/install.md An install step failed: "damaged", Developer Tools access turns off, several macOS installations, zsh: killed, not Apple siliconreferences/install-faq.md Create, start, stop, retry, update a machine, change its Core Bundle references/machines.md Tap, swipe, key, screenshot, anything on vphone.sockreferences/guest-socket.md Call a vphoned method: apps, files, logs, UI tree, processes references/rpc-methods.md Installing an IPA references/rpc-methods.md roothide vs rootless, installing the bootstrap, ssh, /rootfs, handing files to vphoned,.debreferences/guest-layout.md Black screen, timeouts, AMFI, "客体代理未连接" references/troubleshooting.md A symptom the above does not cover; which research note or source explains it references/finding-docs.md Verify with the guest, not with assumptions. After an input, take a screenshot or read
ui.describe; after a launch, checkapps.foreground. The guest is a real device with timing, so a command that returnedokhas not necessarily produced the visible result.
Output and errors
- Progress lines go to stderr as they arrive. The result is one JSON document on stdout. Exit 0 is success; exit 1 is failure with the reason on stderr. Parse stdout, and read stderr when the exit code is 1.
vphone-launchpad-cli helpprints every command with its options and is authoritative if this skill and the installed version disagree.- Quote JSON in single quotes:
guest rpc myphone apps.launch '{"bundle_id":"com.apple.Preferences"}'. - Interrupting the CLI cancels
exec, waits and CFW install. A bundle install or a machine creation belongs to the app window and keeps going, so do not start a second one because the CLI went quiet; runvm log <name> --kind create. - Pass
--root <library>only when two libraries hold a machine with the same name; the error lists the libraries.
Show full SKILL.md (236 more words)Show less
Rules that save the user's machine
These exist because each one has cost the user real time or disk before.
- Use the machines the user named. Do not
vm createto reproduce a problem; diagnose on the existing guest. A creation takes tens of GB and several restarts, and a half-built machine is harder to clean up than the bug. - Creating is one at a time, after checking free disk. IPSWs plus the restore tree are large, and a full disk fails halfway with confusing errors.
- Never change host security settings (SIP, boot-args, AMFI, Research
Guests) and never run
bundle accept,bundle remove,cfw installor a secondvm createover existing work unless the user asked. Report what is needed; the Mac's owner decides. forcemethods need the user's intent.processes.kill,services.stop,apps.uninstall,system.respring,system.reboot,system.shutdownand similar refuse to run without"force":true. Passing it is the confirmation, so pass it only for an action the user asked for.- Do not edit a machine's folder (
~/.vphone/machines/<name>/) while it runs. Use RPC for guest files instead. - Keep the host API listener on loopback.
--api-listensends its token in clear text. - Install apps through installd (
ideviceinstaller) when the point is to test installation;apps.installbypasses installd. Never usexcrun devicectlto install or launch (it times out); listing devices is fine. - When stuck, read before experimenting. The repository's guides and
Research/notes quote real failures; see references/finding-docs.md.
© Lakr233, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 9 other files (references) in Skills/vphone-guest-control of Lakr233/vphone-cli.
- SKILL.md
- 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
Open the folder on GitHubat commit 2032dff
Compare with similar skills
VPhone Guest Control next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| VPhone Guest Control this skillLakr233/vphone-cli | 15k | — | ~1.6k | Automated safety check: Pass | MIT | |
| Apple Crash Log .NET Symbolicationdotnet/skills | 5.6k | 1 repos | ~2.4k | Automated safety check: Pass | MIT | |
| Orca iOS Simulator Controlstablyai/orca | 89k | 1 repos | ~584 | Automated safety check: Pass | Apache-2.0 | |
| Phoneagentrounak/PhoneAgent | 800 | — | ~2.2k | Automated safety check: Pass | MIT | |
| FlowdeckSwiftedMind/Tessera | 116 | — | ~11k | Automated safety check: Pass | MIT | |
| Interceptor iOSHacker-Valley-Media/Interceptor | 522 | — | ~1.9k | Automated safety check: Pass | Custom licence |
Similar skills
- Official
Orca iOS Simulator Control
stablyai/orca
iOS Simulator control from inside Orca, with the live device view in Orca's emulator pane. Use when driving a booted Apple Simulator on macOS: taps, gestures…
Phoneagent
rounak/PhoneAgent
Control a connected iPhone, iOS simulator, Android emulator, or Android device from macOS through PhoneAgent's JSON-RPC bridge.
Flowdeck
SwiftedMind/Tessera
FlowDeck is REQUIRED for all Apple platform build/run/test/launch/debug/simulator/device/log/automation tasks.
Interceptor iOS
Hacker-Valley-Media/Interceptor
Drive any installed app on an owned, unlocked, Developer-Mode iPhone via interceptor ios : ref-tagged element trees, deterministic coordinate taps (click), reliable text entry (type/keys), scroll…
Capture Usage4claude Screenshots
f-is-h/Usage4Claude
Produce every Usage4Claude interface image used by the READMEs and docs.
More from Lakr233/vphone-cli
vphone600 Kernel Symbol Analysis
Lakr233/vphone-cli
Looks up symbols and addresses in vphone600 release and research kernel datasets, and cross-references XNU source, with findings that separate fact from inference.
Authoring VPhone Patch Sets
Lakr233/vphone-cli
Explains how to declare a firmware patch in a vphone patch set, add a new set, or write a preset, including naming, gating and the checks that catch undeclared patches.
Related
Works with
Categories
Questions about VPhone Guest Control
What does VPhone Guest Control do?
Drives a virtual iPhone running on an Apple Silicon Mac through the vphone-launchpad-cli, from checking host setup and starting a machine to tapping, typing and installing apps in the guest. bundle, while vphone-launchpad-cli is a stateless client whose commands also show up in the app's own window and history. The skill insists on using the CLI for everything, since any other route, such as sudo, a separate vphone-cli copy, or devicectl, either lacks the right entitlements, bypasses checks the app records, or times out against these guests.
When should I use VPhone Guest Control?
VPhone Guest Control fits situations like: setting up vphone and creating a new virtual iPhone machine; installing an IPA or a jailbreak bootstrap into a running vphone guest; automating taps, swipes or screenshots inside a vphone guest; debugging a vphone guest that shows a black screen or won't boot.
How do I install VPhone Guest Control in Claude Code?
Run `npx skills add Lakr233/vphone-cli --skill vphone-guest-control -a claude-code`. Or copy the skill folder (Skills/vphone-guest-control in Lakr233/vphone-cli) into .claude/skills/vphone-guest-control in your project. Claude Code loads it when a task matches its description.
How do I install VPhone Guest Control in Codex?
Run `npx skills add Lakr233/vphone-cli --skill vphone-guest-control -a codex`. Or copy the skill folder (Skills/vphone-guest-control in Lakr233/vphone-cli) into .agents/skills/vphone-guest-control in your project. Codex loads it when a task matches its description.
Can I use VPhone Guest Control in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Lakr233/vphone-cli --skill vphone-guest-control -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/vphone-guest-control, .gemini/skills/vphone-guest-control, .github/skills/vphone-guest-control and .opencode/skills/vphone-guest-control in your project.
What does VPhone Guest Control need to run?
Going by SKILL.md and its folder, VPhone Guest Control needs the command-line tools its instructions call (bundle and xcrun). Our summary lists: An Apple Silicon Mac; vphone-launchpad and vphone-launchpad-cli installed.
Does VPhone Guest Control access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is VPhone Guest Control safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does VPhone Guest Control use?
VPhone Guest Control is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does VPhone Guest Control use?
About 1.6k tokens (SKILL.md is roughly 6.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 14k tokens, read only when the agent opens those files.
What are the alternatives to VPhone Guest Control?
Skills that share tags, products or a category with VPhone Guest Control: Apple Crash Log .NET Symbolication (dotnet/skills, 5.6k stars), Orca iOS Simulator Control (stablyai/orca, 89k stars), Phoneagent (rounak/PhoneAgent, 800 stars) and Flowdeck (SwiftedMind/Tessera, 116 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains VPhone Guest Control?
Lakr233 (a GitHub user) maintains it in Lakr233/vphone-cli, which has 15,171 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on October 10, 2026.
Source: Lakr233/vphone-cli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.