mise-xcode-version

English	日本語

A mise plugin that installs shims for xcodebuild, xcrun, and xed. The shims read .xcode-version and switch Xcode per directory.

Installation

mise plugins install mise-xcode-version https://github.com/novr/mise-xcode-version
mise install mise-xcode-version@1

Enable the tool so shims are on PATH: mise use mise-xcode-version@1 (this dir) or mise use -g mise-xcode-version@1 (global). Requires mise activate in your shell.

Or add to .mise.toml:

[plugins]
mise-xcode-version = "https://github.com/novr/mise-xcode-version"

[tools]
mise-xcode-version = "1"

Usage

Put an Xcode version (e.g. 16.3) in .xcode-version in your project. The shims search upward from the current directory, so subdirs work too.

xcodebuild -version
xcrun --find swift

If the version cannot be resolved, the wrapper warns and falls back to the system developer dir (xcode-select -p).

Notes

• macOS only. Does not install Xcode; only points at existing /Applications/Xcode-*.app.
• Shims are xcodebuild / xcrun / xed only. Use xcrun swift for Xcode-bundled Swift.

License

MIT

---

For maintainers

• pack: make pack → xcode-version-shims.tar.gz. Verify: make test.
• release: Update PLUGIN.version in metadata.lua, then git tag v0.x.x && git push origin v0.x.x. Actions attach the tarball to the release.
• Local test: Set MISE_XCODE_SHIMS_URL to the URL serving the tarball, then mise install. Integration: make test-integration.