Skip to content

Prerequisites

  1. Xcode (14.0 or later, 15+ recommended)

    Download from the Mac App Store or Apple Developer.

    After installing, open Xcode once to accept the license agreement and install components.

  2. Xcode Command Line Tools

    Terminal window
    xcode-select --install

    Verify the installation:

    /Applications/Xcode.app/Contents/Developer
    xcode-select -p
  3. Node.js 20 or later

    Install via nodejs.org, Homebrew, or a version manager:

    Terminal window
    # Homebrew
    brew install node@20
    # nvm
    nvm install 20
    nvm use 20
    # Verify
    node --version
    # Expected: v20.x.x or later

These tools extend Xcode Pilot’s capabilities but are not required for core functionality:

ToolPurposeInstall
SwiftLintCode quality analysis and auto-fixbrew install swiftlint
swift-formatCode formatting checksbrew install swift-format
CocoaPodsPod dependency managementsudo gem install cocoapods
xcbeautifyPrettier Xcode build outputbrew install xcbeautify

Run this quick check to make sure everything is ready:

Terminal window
# Xcode CLI tools
xcodebuild -version
# Xcode 16.0 (or your version)
# Simulator runtime
xcrun simctl list runtimes
# Should list iOS runtimes
# Node.js
node --version
# v20.x.x or later

Ready to install? Head to the Installation guide.