XcodesApp

<h1><img src="icon.png" align="center" width=50 height=50 /> <img src="IconDark.png" align="center" width=50 height=50 /> <img src="IconMono.png" align="center" width=50 height=50 /> Xcodes.app</h1>

The easiest way to install and switch between multiple versions of Xcode.

_If you're looking for a command-line version of Xcodes.app, try [`xcodes`](https://github.com/XcodesOrg/xcodes)._

![CI](https://github.com/XcodesOrg/XcodesApp/workflows/CI/badge.svg)

![](screenshot_light.png#gh-light-mode-only)
![](screenshot_dark.png#gh-dark-mode-only)

### :tada: Announcement

XcodesApp is now part of the `XcodesOrg` - [read more here](nextstep.md)

## Features

- List all available Xcode versions from [Xcode Releases'](https://xcodereleases.com) data or the Apple Developer website.
- Install any Xcode version, **fully automated** from start to finish. Xcodes uses [`aria2`](https://aria2.github.io), which uses up to 16 connections to download 3-5x faster than URLSession.
- Automatically resumes installs if network errors.
- Apple ID required to download Xcode versions.
- Just click a button to make a version active with `xcode-select`.
- View release notes, OS compatibility, included SDKs and compilers from [Xcode Releases](https://xcodereleases.com).
- Dark/Light Mode supported
- Security Key Authentication supported 
- Support installing Platforms/Runtimes
- Support installing Apple Silicon variants
- Review and clean developer storage in a separate Clean Up window.

Xcodes can install Apple’s `.aea` archives on macOS versions with `archiveutil extractXcodeAEA`. If Xcode Releases has an outdated download link, try the Apple Developer data source in Settings.

## Clean Up

Clean Up helps you review developer files, caches, and simulator storage. Open it from the bottom-left **Clean Up** button or the app menu. Nothing is selected or deleted automatically.

Xcodes scans on launch. The previous results appear immediately while a background scan refreshes them; the spinner shows when it is running. The window shows the last scan time and identifies cached results. Its **Available to clean up** estimate matches the bottom bar; **Total scanned** also includes incomplete and externally managed storage.

### Default folders

`~` means your home folder. Custom DerivedData and Xcodes storage paths are respected.

| Category | Location |
|---|---|
| Xcode build files | `~/Library/Developer/Xcode/DerivedData` |
| Archives | `~/Library/Developer/Xcode/Archives` |
| Device support | `~/Library/Developer/Xcode/iOS DeviceSupport` |
| Simulator devices | `~/Library/Developer/CoreSimulator/Devices` |
| Simulator runtimes | `/Library/Developer/CoreSimulator` (inventoried through `simctl`) |
| Xcodes downloads | Your configured Xcodes storage folder |

### Your folders

Use **Folders…** or **Settings → Cleanup** to add or remove scan locations. Suggestions include Downloads, device backups, app caches (`~/Library/Caches`), Trash, npm, Cargo, Gradle, and Docker storage; **C