xcodes Release Notes

Highlights

• Refactored the CLI onto the shared, concurrency-enabled XcodesKit package.
• Updated command implementations to use Swift concurrency.
• Added architecture-aware filtering to xcodes list and xcodes runtimes.
• Defaults Xcode and runtime listings to the current Mac architecture.
• Adds architecture labels for available downloads: [Universal], [Apple Silicon], and [Intel].
• Added federated Apple ID authentication support through XcodesLoginKit.
• Removed duplicated local AppleAPI code and old in-repo model code now provided by shared packages.
• Raised package requirements to Swift 6 / macOS 13.
• Added README documentation for architecture filtering.

Architecture Filtering

xcodes list and xcodes runtimes now support filtering by architecture:

xcodes list --architecture arm64
xcodes list --architecture universal
xcodes runtimes --architecture arm64
xcodes runtimes --architecture universal --include-betas

Supported values:

• arm64
• x86_64
• appleSilicon
• universal

When no architecture is provided, xcodes shows downloads appropriate for the current Mac and prints a note explaining how to switch.

Runtime Installation

• Runtime listing and installation now use shared XcodesKit runtime services.
• Runtime output handles architecture-specific downloads more consistently.
• Runtime installs use shared archive and xcodebuild install policy logic.
• Apple Silicon runtime installs can pass the correct architecture variant through the newer xcodebuild path where supported.

Authentication

• Apple ID authentication now uses XcodesLoginKit.
• Federated Apple ID accounts, such as Apple Business Manager accounts, can complete browser-based sign-in and paste the callback URL back into the CLI.
• Fastlane session loading now uses the shared login-kit session loader.

Internal Changes

• Renamed the local library product to XcodesCLIKit.
• Removed the old AppleAPI target and tests.
• Removed PromiseKit/Foundation package dependencies.
• Updated Path.swift and Yams package versions.
• Added shared mocks and test helpers for the new async environment.
• Updated CI for the newer Swift/package setup.

PRs And Contributors

• Builds on runtime architecture work from #437 by @MattKiazyk.
• Incorporates current-machine architecture filtering direction from #459 by @acecilia.
• Relates to architecture-specific install work from #464 by @arietis.
• Incorporates federated authentication support from #465 by @daltonclaybrook.

If you installed xcodes with homebrew you can upgrade with brew upgrade xcodesorg/made/xcodes.

Changes

• Add patchable cryptex disk image handling (#430) @pennig

🧰 Maintenance

• use the correct org name (#429) @pastey

If you installed xcodes with homebrew you can upgrade with brew upgrade robotsandpencils/made/xcodes.

Changes

• Add support for local cryptex disk images (#423) @pennig

If you installed xcodes with homebrew you can upgrade with brew upgrade xcodesorg/made/xcodes.

Big shout out to @abiligiri 🎉 for getting the new Apple SRP login changes over the line! 🙏

Changes

🚀 Enhancements

• Support Service Temporarily Unavailable response error (#389) @noppefoxwolf
• Supports iOS 18+ runtime downloads (#391) @spadafiva

🐛 Bug Fixes

• Add support for SRP Apple login (#393) @MattKiazyk

If you installed xcodes with homebrew you can upgrade with brew upgrade robotsandpencils/made/xcodes.

iOS 18 runtimes are not supported downloading via the xcodes runtimes command. Apple has included a new way to download that is not supported.

Changes

🚀 Enhancements

• Show proper error when authenticating with unsupported hardware keys (#294) @garrettmoon
• Support parsing .xcode-version beta format (#307) @rzulkoski

🐛 Bug Fixes

• Quick fix to ignore new iOS 18 runtime downloadables (#370) @alvar-bolt
• Always respect select flag during install (#310) @DylanBettermannDD

🧰 Maintenance

• Bump github.com/mxcl/promisekit from 6.8.5 to 6.22.1 (#342) @dependabot
• Bump github.com/mxcl/legibleerror from 1.0.4 to 1.0.6 (#339) @dependabot
• Bump release-drafter/release-drafter from 5 to 6 (#337) @dependabot
• Add dependabot support for swift (#318) @kemchenj
• Bump actions/checkout from 3 to 4 (#315) @dependabot

If you installed xcodes with homebrew you can upgrade with brew upgrade xcodesorg/made/xcodes.

Did you know that Xcodes CLI support downloading and installing Apple Runtimes!

xcodes runtimes --include-betas
xcodes runtimes install "visionOS 1.0-beta1"

Changes

🚀 Enhancements

• feat: add support for VisionOS runtime download (#300) @MattKiazyk

🧰 Maintenance

• Update README.md (#297) @ThePredators

If you installed xcodes with homebrew you can upgrade with brew upgrade robotsandpencils/made/xcodes.

⚠⚠ Apple has implemented a version of Hashcash when logging in, which caused previous versions to lock Apple ID's. This effect all tools that implemented the similar auth/signin api's. The fix should stop any new locks of Apple ID's. If your Apple ID is locked, you must reset your password. ⚠⚠

Changes

🐛 Bug Fixes

• Implement hashcash for AppleID Authentication (#276) @MattKiazyk

🚀 Enhancements

• Update unxip to use 1.1.3 code (#271) @MattKiazyk
• Add support for Apple API sessions from Fastlane Spaceship (#257) @adamprice
• Add a download runtimes command (#267) @StevenSorial
• Better Handling of Apple Unauthorized errors (#249) @dmytro-kasianchuk-doordash
• use simpler 'release' instead of 'non-prerelease' word in user-facing… (#239) @pastey

If you installed xcodes with homebrew you can upgrade with brew upgrade robotsandpencils/made/xcodes.

Changes

This returns the requirement of having to log in via your Apple username/password. :(

In happier news - thanks to @Stevenmagdy you can now download simulators runtimes via xcodes runtimes install with the speed of aria2! 🚀

🚀 Enhancements

• Support runtime downloading/installing (#230) @Stevenmagdy
• Update select command to use .xcode-version (#238) @daltonclaybrook

🐛 Bug Fixes

• restore downloading via xcodereleases with apple username/password :( (#245) @MattKiazyk

🧰 Maintenance

• Add contributing guide (#237) @MattKiazyk

If you installed xcodes with homebrew you can upgrade with brew upgrade robotsandpencils/made/xcodes.

Changes

🚀 Enhancements

• Add select option to install (#182) @tahirmt
• Update the cached list of available Xcodes if it's more than 24 hours old (#226) @rpendleton
• Add a command for listing available simulators (#223) @Stevenmagdy
• Add "version" argument to "installed" function, printing Xcode's installation path (#220) @rogerluan

🐛 Bug Fixes

• Exit immediately if trying to select currently selected xcode (#181) @tahirmt

🧰 Maintenance

• Use mocks when writing the cache file in unit tests (#227) @rpendleton
• Add documentation for the .xcode-version file (#218) @rogerluan
• Lint Markdown Files (#217) @rogerluan

If you installed xcodes with homebrew you can upgrade with brew upgrade robotsandpencils/made/xcodes.

Xcodes now DOES NOT require any Apple ID and password when downloading Xcode! 🎉

At long last! you no longer are required to provide your Apple username and password in order to download Xcode (as long as your using XcodeReleases datasource).

• No more 2FA prompts!
• No more errors when you haven't signed the latest developer EULA!
• No more nervous feeling giving your password to a 3rd Party.

Changes

🚀 Enhancements

• Add ability to download Xcode without logging in using XcodeRelease (#215) @MattKiazyk
• Added support to immediately delete Xcode and its XIPs (#211) @juanjonol
• Added no-superuser flag (#207) @juanjonol

🧰 Maintenance

• Update Makefile - refactor swift-build option (#214) @ahmetgeymen
• update unxip to the latest version (#209) @rpendleton
• Fix broken unit tests due to new logs and Xcode version (#189) @tahirmt