List all available iOS simulators with their UDID, name, state (Booted/Shutdown), and runtime version. Use this first to find a simulator to work with.

Boot an iOS simulator by its UDID. The booted simulator becomes the active device for subsequent commands.

Shut down a running iOS simulator.

Launch an iOS application by its bundle identifier (e.g. 'com.example.myapp'). The simulator must be booted first.

Terminate (force close) a running iOS application.

List all installed apps on the simulator with their bundle IDs and display names.

Open a URL or deep link on the simulator. Can be used to open web pages in Safari or trigger deep links into apps (e.g. 'myapp://screen/profile').

Take a screenshot of the current simulator screen. Returns the image as base64-encoded PNG. Use this to see what's currently displayed on screen.

List all visible UI elements on the current screen with their types, labels, values, and coordinates. Use this to find elements to tap or type into. Each element shows its position (x,y) and size.

Get the screen dimensions (width and height in pixels) of the simulator.

Tap on the screen at the specified (x, y) coordinates. Use pt_list_elements first to find the coordinates of the element you want to tap.

Swipe from one point to another on the screen. Use for scrolling, dismissing, or navigating between screens.

Type text into the currently focused field, or tap a field first then type.

STRATEGIES:

• "paste" (default, RECOMMENDED): Uses clipboard + Cmd+V paste. Works reliably with React Native controlled TextInput components that use onChangeText.

• "keyboard": Uses HID keyboard events. Faster but may NOT work with React Native controlled inputs.

IMPORTANT: For React Native apps, always use the "paste" strategy (the default). If you know the (x,y) coordinates of the text field, provide them to auto-tap and focus first.

Press a hardware button on the simulator (Home, Lock, Siri, Apple Pay).

Set the simulator's clipboard/pasteboard content. Useful for preparing text to paste into fields.

Read the current contents of the simulator's clipboard/pasteboard.

Fill a React Native TextInput by connecting to the Hermes debugger via CDP.

This is the MOST RELIABLE method for filling React Native controlled TextInput fields. It walks the React fiber tree, finds the component matching your identifier, and calls its onChangeText callback directly inside the JS runtime.

REQUIREMENTS:

• Metro dev server must be running (default: localhost:8081)

• App must be in development mode (DEV = true)

• The TextInput must be currently rendered on screen

The identifier is matched against accessibilityLabel, testID, or placeholder (case-insensitive partial match).

List all TextInput components currently rendered in the React Native app.

Connects to the Hermes debugger via CDP and walks the React fiber tree to find all components with an onChangeText prop. Returns their name, placeholder, accessibilityLabel, testID, and current value.

Use this to discover which inputs are available before calling pt_fill_input.