ax-simulator

Simulator Management

Quick Patterns

simctl Device Lifecycle

# List available devices
xcrun simctl list devices

# Boot a simulator
xcrun simctl boot "iPhone 16"

# Get booted simulator UDID
UDID=$(xcrun simctl list devices -j | jq -r '.devices | to_entries[] | .value[] | select(.state == "Booted") | .udid' | head -1)

# Open Simulator app
open -a Simulator

# Shutdown
xcrun simctl shutdown $UDID

# Erase (reset to factory)
xcrun simctl erase $UDID

# Delete
xcrun simctl delete $UDID

simctl App Management

# Install app
xcrun simctl install $UDID /path/to/MyApp.app

# Launch app
xcrun simctl launch $UDID com.example.myapp

# Launch with arguments
xcrun simctl launch $UDID com.example.myapp --uitesting --mock-data

# Terminate app
xcrun simctl terminate $UDID com.example.myapp

# Uninstall app
xcrun simctl uninstall $UDID com.example.myapp

simctl Utilities

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

# Video recording (Ctrl+C to stop)
xcrun simctl io $UDID recordVideo /tmp/recording.mp4

# Open URL / deep link
xcrun simctl openurl $UDID "myapp://path/to/screen"

# Send push notification
xcrun simctl push $UDID com.example.myapp /tmp/push.json

# Set status bar (clean screenshots)
xcrun simctl status_bar $UDID override --time "9:41" --batteryState charged --batteryLevel 100

# Grant permissions
xcrun simctl privacy $UDID grant photos com.example.myapp
xcrun simctl privacy $UDID grant camera com.example.myapp
xcrun simctl privacy $UDID grant location-always com.example.myapp

# Add photos/videos to library
xcrun simctl addmedia $UDID /path/to/photo.jpg

# Set location
xcrun simctl location $UDID set 37.7749,-122.4194

# Get app container path
xcrun simctl get_app_container $UDID com.example.myapp data

Push Notification Payload

{
  "aps": {
    "alert": {
      "title": "Test Notification",
      "body": "This is a test push notification"
    },
    "badge": 1,
    "sound": "default"
  }
}

xcrun simctl push $UDID com.example.myapp /tmp/push.json