install-xcode-vm
/install-xcode-vm
Install an older Xcode from a XIP into a provisioned macOS VM, with optional iOS simulator runtimes (iOS 15 and 16 by default), and snapshot it — for running UTM on iOS versions the host's current Xcode no longer has simulators for. Runtimes download unattended: iOS 16 and later through that Xcode (xcodebuild -downloadPlatform -buildVersion), iOS 15 and older from Apple's public simulator index. Use when asked to set up an Xcode VM, install Xcode in a VM, or get iOS 15/16 simulators.
- Author
- utmapp ↗
- Repository
- utmapp-bot ↗
- Licence
- Apache-2.0
- Last repository change
- 12.11.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 12.11.2026, without references to retired models or APIs.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
What it does and when to use it
Install an older Xcode from a XIP into a provisioned macOS VM, with optional iOS simulator runtimes (iOS 15 and 16 by default), and snapshot it — for running UTM on iOS versions the host's current Xcode no longer has simulators for. Runtimes download unattended: iOS 16 and later through that Xcode (xcodebuild -downloadPlatform -buildVersion), iOS 15 and older from Apple's public simulator index. Use when asked to set up an Xcode VM, install Xcode in a VM, or get iOS 15/16 simulators.
Arguments
/install-xcode-vm [VM] [--xip FILE] [--ios VER ...] [--ios-dmg FILE ...]
Original author description
Install an older Xcode from a XIP into a provisioned macOS VM, with optional iOS simulator runtimes (iOS 15 and 16 by default), and snapshot it — for running UTM on iOS versions the host's current Xcode no longer has simulators for. Runtimes download unattended: iOS 16 and later through that Xcode (xcodebuild -downloadPlatform -buildVersion), iOS 15 and older from Apple's public simulator index. Use when asked to set up an Xcode VM, install Xcode in a VM, or get iOS 15/16 simulators.
How it works
- Before running
- What it does
- Output
SKILL.md preview
---
name: install-xcode-vm
description: Install an older Xcode from a XIP into a provisioned macOS VM, with optional iOS simulator runtimes (iOS 15 and 16 by default), and snapshot it — for running UTM on iOS versions the host's current Xcode no longer has simulators for. Runtimes download unattended: iOS 16 and later through that Xcode (xcodebuild -downloadPlatform -buildVersion), iOS 15 and older from Apple's public simulator index. Use when asked to set up an Xcode VM, install Xcode in a VM, or get iOS 15/16 simulators.
argument-hint: "[VM] [--xip FILE] [--ios VER ...] [--ios-dmg FILE ...]"
---
# Install Xcode in a macOS VM
Arguments: `$ARGUMENTS`
The host's Xcode has only the latest iOS simulators (Xcode 27 dropped iOS 15
and 16). Its builds still target UTM's minimum iOS, so the older simulators
are what the VM provides: run the host's build there
(`/utmapp-bot:test-utm-ui`). The VM's own Xcode builds only code that still
compiles with its older SDK.
```sh
UB="${CLAUDE_PLUGIN_ROOT}/bin/utmbot"
$UB lock acquire --purpose "Xcode VM" --wait 3600
$UB mac xcode "macOS 15" --xip ~/Downloads/Xcode_26.6_Apple_silicon.xip --ios 15.5 --ios 16.4
$UB lock release
```
## Before running
- **The VM.** A VM from `/utmapp-bot:provision-macos-vm` on a macOS the Xcode
supports (Xcode 26 needs macOS 15.6 or later: the `macOS 15` or `macOS 26`
VM), provisioned with room for it (`--disk-gb 200 --memory 12288`). It
checks the free space before copying.
- **The XIP.** From the user (`~/Downloads/Xcode_<version>_Apple_silicon.xip`
by default); never download Xcode yourself (it needs their Apple ID).
- **Runtimes.** `--ios 15.5 --ios 16.4` by default when the user asks for
"iOS 15 and 16"; use the versions they name. Nothing is downloaded by
hand:
1. iOS 16.0 and later: `xcodebuild -downloadPlatform iOS -buildVersion
<version>` in the VM (Xcode 16.1 and later);
2. iOS 15 and older, which Xcode does not offer: Apple's public simulator
index (`devimages-cdn.apple.com`), downloaded once into
`~/.utmapp-bot/cache/simruntimes` and installed from there.
`--ios-dmg FILE` installs a runtime DMG already on this Mac (offline).
## What it does
1. Starts the VM and waits for SSH.
2. Copies the XIP in, expands it with `xip --expand` (which checks Apple's
signature), moves it to `/Applications/Xcode-<version>.app`.
3. `xcode-select -s`, `xcodebuild -license accept`, `-runFirstLaunch`, and
the iOS platform of that Xcode (`xcodebuild -downloadPlatform iOS`, about
8 GB) and the Metal toolchain (`-downloadComponent MetalToolchain`):
without them Xcode builds nothing for a simulator.
4. Installs each runtime: an old runtime DMG holds a package whose payload is
the `.simruntime` bundle; it goes into the user's
`~/Library/Developer/CoreSimulator/Profiles/Runtimes` (the package's own
target is CoreSimulator's protected system folder). A runtime disk image
goes in with `simctl runtime add`.
5. Shuts the VM down and snapshots it as `xcode-<version>` (labels: the
Xcode version and runtimes), on top of `macos-baseline`.
It resumes: an installed Xcode is not copied again, and an installed
runtime is skipped.
## Output
The Xcode version, `xcrun simctl list runtimes` in the VM, the snapshot, and
any runtime that needs the user's download.
Versions
The database has no other skills named install-xcode-vm.
Database snapshot: 13.11.2026 · package version de04457cd575 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100test-utm-ui
Test a UTM UI change on several macOS and iOS versions, as UTM's contribution guidelines ask — build UTM with the change, run it in macOS VMs (12 through the newest) and in iOS simulators (the host's newest iOS, and older iOS in a macOS VM with an older Xcode), and screenshot… - 90xcode-simulator-testing
Use when asked to run /xcode-simulator-testing with a scheme name or current to build and launch an iOS app in a simulator. Not for project regeneration: use ios-build-fix. - 90ce-test-xcode
Test iOS apps in a simulator with XcodeBuildMCP. Use when iOS changes need simulator evidence before handoff. - 100xcodebuild
Build, test, and archive iOS/macOS apps with xcodebuild and Xcode CLI tools. Use for CI integration, scheme management, simulator control, and build troubleshooting. - 100ios-simulator-skill
Build, test, and drive iOS apps in the Simulator with 30 token-efficient scripts. Use when asked to build or test an Xcode project, launch an app on a simulator, tap/type/swipe through its UI by accessibility label, take screenshots or visual diffs, audit accessibility, read… - 95ios-simulator-skill
Build and test Xcode projects; launch and inspect iOS Simulator apps, navigate by accessibility labels, capture screenshots and logs, and diagnose simulator issues. Use for authorized simulator lifecycle and UI testing on macOS. Requires Xcode, Python 3.12+ and idb for…