Skip to content

app_list

Lists all user-installed applications on a simulator device, returning their bundle identifiers, display names, version numbers, and bundle paths. This is useful for verifying installations, finding the correct bundle ID for other app lifecycle operations, or auditing which apps are present on a test simulator.

Parameters

Parameter	Type	Required	Default	Description
`deviceId`	string	Yes	—	The UDID of the target simulator device.

Usage Examples

List all installed apps

“What apps are installed on my test simulator?”

{
  "deviceId": "F3A1B2C3-D4E5-6789-ABCD-EF0123456789"
}

Verify a specific simulator’s apps

“Show me all apps on the iPad Air simulator.”

{
  "deviceId": "B9C8D7E6-F5A4-3210-9876-FEDCBA987654"
}

Example Output

Installed apps on F3A1B2C3-D4E5-6789-ABCD-EF0123456789:

1. WeatherApp
   Bundle ID: com.example.weatherapp
   Version: 2.1.0 (45)
   Path: /Users/dev/Library/Developer/CoreSimulator/Devices/F3A1B2C3-D4E5-6789-ABCD-EF0123456789/data/Containers/Bundle/Application/1A2B3C4D-5E6F-7890-ABCD-EF0123456789/WeatherApp.app

2. ShopApp
   Bundle ID: com.example.shopapp
   Version: 1.5.2 (112)
   Path: /Users/dev/Library/Developer/CoreSimulator/Devices/F3A1B2C3-D4E5-6789-ABCD-EF0123456789/data/Containers/Bundle/Application/2B3C4D5E-6F78-9012-BCDE-F01234567890/ShopApp.app

3. NotesApp
   Bundle ID: com.example.notesapp
   Version: 3.0.0 (7)
   Path: /Users/dev/Library/Developer/CoreSimulator/Devices/F3A1B2C3-D4E5-6789-ABCD-EF0123456789/data/Containers/Bundle/Application/3C4D5E6F-7890-1234-CDEF-012345678901/NotesApp.app

Total: 3 apps

app_install — Install an app onto the simulator.
app_uninstall — Uninstall an app using its bundle ID from this list.
app_launch — Launch an app using its bundle ID from this list.
simulator_list — List available simulators to find the device ID.

Tips