Skip to content
Skills Library
Programming · Automation

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.

Repository
utmapp-bot ↗
Licence
Apache-2.0
Last repository change
12.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 12.11.2026, without references to retired models or APIs.

Licence

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

  1. Before running
  2. What it does
  3. Output
Original SKILL.md headings · 61 lines, 391 words
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…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.