whatisgithub

What is xcodes?

xcodesorg/xcodes — explained in plain English

Analysis updated 2026-06-26

4,653SwiftAudience · developerComplexity · 2/5Setup · easy

In one sentence

A Mac command-line tool that installs, manages, and switches between multiple Xcode versions automatically, removing the need to manually download them from Apple's website.

Mindmap

mindmap
  root((xcodes))
    What it does
      Install Xcode versions
      Switch active Xcode
      Manage simulators
    Key features
      Apple ID auth
      Fast parallel download
      Xcode-version file
    Use cases
      Team consistency
      CI pipelines
      Disk management
    Tech
      Swift
      macOS only
      Homebrew
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Install a specific Xcode version with one command instead of navigating Apple's developer portal manually

USE CASE 2

Switch the active Xcode version on your Mac for a particular project or CI pipeline in seconds

USE CASE 3

Add a .xcode-version file to a project repo so every team member automatically uses the same Xcode version

USE CASE 4

Download iOS simulator runtimes separately from Xcode to manage disk space

What is it built with?

SwiftHomebrew

How does it compare?

xcodesorg/xcodesnmac427/swiftocrmangerlahn/latest
Stars4,6534,6384,609
LanguageSwiftSwiftSwift
Setup difficultyeasyeasyeasy
Complexity2/52/51/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires an Apple ID and accepts Apple's developer terms during first install.

So what is it?

xcodes is a command-line tool for Mac developers that makes it easy to install and switch between multiple versions of Xcode, Apple's development environment for building apps for iPhone, iPad, and Mac. Normally, managing more than one Xcode version involves manually downloading large files from Apple's website and keeping track of which version is active. xcodes automates that process. The most common use is to run a single command like "xcodes install 15.2" and have it handle everything: authenticating with your Apple ID, downloading the file, unpacking it, moving it to your Applications folder, and verifying that it installed correctly. If you have aria2 installed, xcodes uses it to download files significantly faster by opening multiple connections at once. You can also install simulator runtimes for different iOS versions separately from Xcode itself. Switching between versions is handled with the "xcodes select" command, which changes which Xcode your system uses when you build or run development tools. You can list installed versions, uninstall versions you no longer need, and check which versions are available to download. For teams and CI pipelines, xcodes supports a small text file called .xcode-version placed in a project directory. This file declares which Xcode version the project expects, making it easy for everyone on a team to stay consistent without having to communicate the version out of band. xcodes is available via Homebrew and is written in Swift. It is signed and notarized by Apple, meaning it will run without security warnings on modern macOS. A companion app with a graphical interface is available separately as Xcodes.app.

Copy-paste prompts

Prompt 1
I need to install Xcode 15.2 on my Mac using xcodes. Walk me through the exact commands to authenticate with Apple ID and install it.
Prompt 2
My CI pipeline needs a specific Xcode version before building. Write a shell script that uses xcodes to select the version declared in the .xcode-version file.
Prompt 3
I have multiple Xcode versions installed with xcodes. Show me how to list all installed versions and uninstall the ones I no longer need.
Prompt 4
Help me set up a .xcode-version file in my iOS project repo so xcodes automatically selects the right Xcode when I run it.

Frequently asked questions

What is xcodes?

A Mac command-line tool that installs, manages, and switches between multiple Xcode versions automatically, removing the need to manually download them from Apple's website.

What language is xcodes written in?

Mainly Swift. The stack also includes Swift, Homebrew.

How hard is xcodes to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is xcodes for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.