Xcode versions and simulators with Termhint
Updated 19 November 2026All docs
Termhint installs several Xcode versions side by side, switches between them per folder, makes one the Mac's default and manages simulator runtimes. This page covers the Apple sign-in, the commands, how each Xcode is verified, and the optional administrator helper. Other runtimes are on Runtime versions.
Sign in to Apple
Downloading Xcode needs an Apple developer session. Sign in once in Settings → Runtimes → Languages → Xcode → Sign In…, which opens Apple's own sign-in page. Termhint never sees your password.
The session is kept in your login Keychain (service dev.termhint.apple-developer-session) and is only sent to HTTPS hosts under apple.com. Sign Out… in the same place removes it. From a terminal:
termhint xcode session status # whether a session is stored
termhint xcode session status --check # also ask Apple whether it still accepts it
termhint xcode session clear # remove the stored session
You do not need to sign in to adopt an Xcode that is already in /Applications or to install from a .xip you downloaded yourself.
List the Xcode versions
termhint runtime list-remote xcode # releases this Mac can run
termhint runtime list-remote xcode --all # betas and release candidates too
The list comes from xcodereleases.com. It keeps only releases whose minimum macOS is at most yours and that have a build for your Mac, and only .xip downloads from download.developer.apple.com.
Versions are written 27.2, 27.3-beta.2 or 27.2-rc, or quoted the way xcodes writes them, "27.3 Beta 2". A developer preview counts as a beta, a GM seed as a release candidate and a GM as the release.
Install an Xcode
termhint runtime install xcode 27.2
termhint runtime install xcode 27.3-beta.2
termhint runtime install xcode 27.2 --from ~/Downloads/Xcode_27.2.xip
termhint runtime install xcode --from /Applications/Xcode.app
What happens:
- If
/Applications/Xcode-<version>.appis already there (the name xcodes uses), it is adopted: its signature is checked and it stays where it is. - Otherwise Termhint downloads the
.xipwith your Apple session. An interrupted download continues where it stopped. With--from <file>.xip, your own file is used instead. - The
.xipis checked, expanded with Apple'sxipin a temporary folder inside/Applications, and the app in it is checked again. - The app is moved to
/Applications/Xcode-<version>.app, and Termhint's store keeps a record and a link to it.
--from <app> adopts an Xcode app where it is. Its version must be the one you asked for; with no version, the app's own is taken.
Expanding takes several minutes and needs free space in /Applications. Your user must be allowed to add apps there. A downloaded .xip is deleted after the install, and also when it fails the signature check.
Note: After installing, run the first launch (see First launch) before you build with that Xcode.
Verification
Every check uses Apple's own tools, and anything that fails one is refused:
- The
.xipmust passpkgutil --check-signaturewith Apple's Software Update certificate chain up to Apple Root CA.xipchecks the archive's own checksums while expanding. - The app must pass
codesign --verify --deep --strictascom.apple.dt.Xcodesigned by Apple, with team ID59GAB85EFGand Apple's certificate chain. - Gatekeeper (
spctl --assess) must accept the app as Apple's. - The app's version must be the one you asked for.
Nothing reaches its final name in /Applications before every check has passed.
Switch Xcode versions
Per folder
termhint runtime use xcode 26.6 # writes `xcode 26.6` to .tool-versions here
In that folder and the ones below it, the shell sets DEVELOPER_DIR to that Xcode's Contents/Developer folder. Xcode adds nothing to PATH.
Termhint also reads .xcode-version, the file xcodes and fastlane write (the whole first line, for example 16.3 Beta 2). The rules for which file wins are on Runtime versions.
The Mac's default
termhint xcode select 27.2
This makes the version your global default (as termhint runtime use -g xcode 27.2 does) and runs xcode-select -s for the whole Mac. xcode-select -s changes a system setting, so it asks for an administrator password once. If that Xcode is already selected, nothing more happens.
In Settings → Runtimes, the same step is Make Default.
First launch
termhint xcode first-launch 27.2
This accepts the Xcode license (xcodebuild -license accept) and runs its first launch (xcodebuild -runFirstLaunch). Both run as root, so it asks for an administrator password once. In Settings → Runtimes, the same step is Finish Setup. It takes a few minutes.
The app in /Applications belongs to you, so any program running as you could change it. Before running anything as root, Termhint moves the app into a new folder only root can reach, checks Apple's signature again there, runs xcodebuild from that folder and then moves the app back. The app's owner is never changed.
Simulator runtimes
termhint xcode platforms # installed simulator runtimes, with their ids
termhint xcode platforms 27.2 # as a given Xcode sees them
termhint xcode platform install iOS # iOS, watchOS, tvOS or visionOS (any case)
termhint xcode platform install iOS --xcode 27.2
termhint xcode platform remove <id> # one runtime, by the id `platforms` prints
- Without a version, the Xcode the current shell uses is asked, else the system's.
platform installrunsxcodebuild -downloadPlatform <platform>with that Xcode, so Apple's own download and checks apply. It needs no administrator.platform removerunssimctl runtime delete. Simulators on that runtime shut down first. A runtime that comes inside an Xcode cannot be removed on its own. Runtimes are shared by every Xcode.
In Settings → Runtimes, each installed Xcode has Simulators…: the runtimes that Xcode's SDKs use, with an Install button for each platform whose runtime is still missing. A runtime no installed Xcode uses shows in none of them; remove it with termhint xcode platform remove <id>.
Remove an Xcode
termhint runtime uninstall xcode 26.6
The app is moved to your Trash and its record is removed. Termhint refuses to remove the Xcode that xcode-select -p points to; make another one the default first with termhint xcode select <version>.
- An Xcode on another volume than your Trash: move it to the Trash in Finder.
- An Xcode that an older Termhint made owned by root: macOS lets no one change an app's files once it has run, so move it to the Trash in Finder, then run the command again to drop its record.
- An Xcode you moved to the Trash yourself drops out of
termhint runtime listand Settings → Runtimes on its own.
The administrator helper
Make Default and Finish Setup need an administrator. Without the helper, each one asks for your password. The optional administrator helper lets Termhint.app run them without a password:
- Click Turn On… next to Administrator helper in Settings → Runtimes → Languages → Xcode.
- Approve it once in System Settings → General → Login Items & Extensions.
How it is limited:
- It runs as root, started by macOS only while it is used, and quits a minute after its last request.
- It talks only to Termhint.app over XPC, and each side checks the other's code signature.
- It does only two things:
xcode-select -sand the license plus first launch. It takes nothing but the path of an Xcode directly in/Applications, and refuses anything else.
The helper serves the app only. termhint xcode select and termhint xcode first-launch in a terminal always ask through sudo.
To remove it, turn it off in the same place. See also Uninstall.
Move from xcodes
Settings → Runtimes → Other Managers lists Xcodes (the app or the xcodes command), with Replace with Termhint…. From a terminal:
termhint runtime migrate --dry-run xcodes
termhint runtime migrate xcodes
The Xcodes already in /Applications are adopted where they are, not downloaded again. More: xcodes alternative and moving from other managers.
Command reference
| Command | What it does |
|---|---|
termhint runtime list-remote xcode [--all] [--refresh] |
Xcode releases this Mac can run |
termhint runtime install xcode [<version>] [--from <xip or app>] [--refresh] |
Download, or install from a .xip, or adopt an app |
termhint runtime use [-g] xcode <version> |
Pin an Xcode in this folder, or as the shell's default |
termhint runtime list xcode |
Installed Xcodes |
termhint runtime uninstall xcode <version> |
Move an Xcode to the Trash |
termhint xcode select <version> |
Make it the default and run xcode-select -s (administrator) |
termhint xcode first-launch <version> |
Accept the license and run the first launch (administrator) |
termhint xcode platforms [<version>] |
Installed simulator runtimes and the platforms to download |
termhint xcode platform install <platform> [--xcode <version>] |
Download a simulator platform |
termhint xcode platform remove <id> |
Remove a simulator runtime |
termhint xcode session status [--check] |
Whether an Apple session is stored |
termhint xcode session clear |
Remove the stored Apple session |