mise-xcode

Xcode plugin for the Mise version manager.

Note

This plugin manages your actively selected Xcode version, but does not take the responsibility of downloading or installing Xcode versions themselves.

Install

Option 1: Specify the plugin inside your project's configuration

[plugins]
xcode = 'https://github.com/michalpopek/mise-xcode'

Option 2: Install the plugin globally

mise plugins install xcode https://github.com/michalpopek/mise-xcode

Use

Selecting the latest stable version of Xcode

mise use xcode@latest

or

[tools]
xcode = 'latest'

This resolves to the latest stable Xcode version known by the plugin.

Selecting a specific version of Xcode

[tools]
xcode = '16.0.0'

Selecting the latest stable version of a major Xcode

Using version 26 will select the latest stable 26.x.y release known by the plugin.

foo@bar:~$ mise use xcode@26
mise ~/foo/bar/mise.toml tools: xcode@26.5.0

Selecting a version with an .xcode-version file

The plugin can read the version from an .xcode-version file, the format used by xcodes and fastlane. mise only reads idiomatic version files for tools you opt in, so enable it for xcode first:

mise settings add idiomatic_version_file_enable_tools xcode

Then, in your project:

foo@bar:~$ echo "26.2" > .xcode-version
foo@bar:~$ mise current xcode
26.2.0

The file is read the way xcodes reads it, so the version it names is exact:

.xcode-version	Resolved version
26, 26.0	26.0.0
26.0.1, Xcode 26.0.1	26.0.1
14.0b6, 14.0 Beta 6	14.0.0-beta.6
26.3 RC 2, 26.3 Release Candidate 2	26.3.0-rc.2
10.2 GM seed	10.2.0-seed

This differs from versions in mise.toml, where xcode = '26.0' follows mise's usual prefix matching and selects the latest 26.0.x release. Anything else in the file is used as written, e.g. 26.0.0-beta.3.

Selecting Xcodes within a specific search path

By default, this plugin looks for Xcode installations with a search path of /, i.e. anywhere on your disk. You can specify a custom search path via the search_path parameter:

[tools]
xcode = {version='16.0.0', search_path='/Applications'}

Troubleshooting

No Xcode <version> installation found within search path.

The plugin was not able to find a valid Xcode installation for the provided version.

Make sure you have it installed and it's available inside the search path. By default, this plugin looks for Xcode installations with a search path of /, i.e. anywhere on your disk.

The plugin links each mise installation to the selected Xcode's Contents/Developer directory. If you move or rename the Xcode application after selecting it, refresh the link:

mise install --force xcode@<version>

No Xcode version exists that corresponds to <version>.

According to the plugin, this Xcode version doesn't exist at all.

Double check that the Xcode version you're trying to use is accounted for at xcodereleases.com.