ios-simulator

name	ios-simulator
description	Automate iOS Simulator workflows (simctl + idb): create/boot/erase devices, install/launch apps, push notifications, privacy grants, screenshots, and accessibility-based UI navigation. Use when working with iOS apps, Xcode, Simulator, simctl, idb, UI automation, or iOS testing.

iOS Simulator Automation

This skill provides a Node-only CLI wrapper around:

• xcrun simctl for simulator/device/app management
• idb for accessibility-tree inspection + synthesised UI input (tap/text/button)

It is designed for AI agents: minimal, structured output by default, with opt-in detail.

Important constraints

• Must run on macOS with Xcode Command Line Tools (or Xcode) available.
• If the ClawdBot gateway is not macOS, run these commands on a connected macOS node (see “Remote macOS node” below).
• idb is optional, but required for UI tree / semantic tapping. (Install steps below.)

Quick start

# 1) Sanity check
node {baseDir}/scripts/ios-sim.mjs health

# 2) List simulators (compact)
node {baseDir}/scripts/ios-sim.mjs list

# 3) Select a default simulator (writes .ios-sim-state.json in the current dir)
node {baseDir}/scripts/ios-sim.mjs select --name "iPhone" --runtime "iOS" --boot

# 4) Install + launch an .app
node {baseDir}/scripts/ios-sim.mjs app install --app path/to/MyApp.app
node {baseDir}/scripts/ios-sim.mjs app launch --bundle-id com.example.MyApp

# 5) Inspect current UI (requires idb)
node {baseDir}/scripts/ios-sim.mjs ui summary
node {baseDir}/scripts/ios-sim.mjs ui tap --query 
node {baseDir}/scripts/ios-sim.mjs ui  --text 


node {baseDir}/scripts/ios-sim.mjs screenshot --out artifacts/screen.png