xcode-build

Xcode Build Direct

Build and manage iOS/macOS projects using native Xcode CLI tools. The core workflow uses Xcode/macOS command-line tools only; optional third-party helpers are called out separately when shown.

When to Use This Skill

Use this skill when:

• Building iOS or macOS apps with Xcode
• Running apps in iOS simulators
• Managing simulator instances (boot, shutdown, list)
• Taking screenshots of simulators
• Capturing app logs
• Running tests (unit or UI)
• Automating UI interactions (tap, type, swipe)

Preference: Use direct CLI commands (xcodebuild, xcrun simctl) when you need portable, inspectable build evidence. If a project has a proven richer tooling path, such as XcodeBuildMCP, simulator automation, or a repo-local harness, follow that project-specific path.

Quick Start

1. Discover Project Structure

# List schemes in a workspace
xcodebuild -workspace /path/to/App.xcworkspace -list

# List schemes in a project
xcodebuild -project /path/to/App.xcodeproj -list

# Show build settings
xcodebuild -workspace /path/to/App.xcworkspace -scheme AppScheme -showBuildSettings

2. Find Available Simulators

# List all simulators
xcrun simctl list devices

# List as JSON (better for parsing)
xcrun simctl list devices --json

# List only available simulators
xcrun simctl list devices available

3. Build for Simulator

# List available simulators, then copy the UUID between parentheses.
xcrun simctl list devices available
UDID="PASTE-SIMULATOR-UUID-HERE"

# Build
xcodebuild \
  -workspace /path/to/App.xcworkspace \
  -scheme AppScheme \
  -destination "platform=iOS Simulator,id=$UDID" \
  -configuration Debug \
  -derivedDataPath /tmp/build \
  build

4. Install and Launch

# Find the built .app
APP_PATH=$(find /tmp/build -name "*.app" -type d | head -1)

# Install on simulator
xcrun simctl install $UDID "$APP_PATH"

# Launch app
xcrun simctl launch $UDID com.your.bundleid

5. Take Screenshot

xcrun simctl io $UDID screenshot /tmp/screenshot.png