simctl-app
Install, uninstall, launch, and terminate iOS apps on simulators. Use UDID for simulator identification and bundle ID for app targeting.
Instructions
simctl-app
Unified iOS app lifecycle management - install, uninstall, launch, terminate.
Overview
Single tool for app management on simulators. Routes to specialized handlers while maintaining clean operation semantics.
Operations
install
Install iOS app to simulator.
Parameters:
udid(string): Simulator UDID (from simctl-list)appPath(string): Path to .app bundle
Example:
await simctlAppTool({
operation: 'install',
udid: 'ABC-123-DEF',
appPath: '/path/to/MyApp.app'
})uninstall
Uninstall iOS app from simulator.
Parameters:
udid(string): Simulator UDIDbundleId(string): App bundle ID (e.g., com.example.MyApp)
Example:
await simctlAppTool({
operation: 'uninstall',
udid: 'ABC-123-DEF',
bundleId: 'com.example.MyApp'
})launch
Launch iOS app on simulator.
Parameters:
udid(string): Simulator UDIDbundleId(string): App bundle IDarguments(string[], optional): Command-line argumentsenvironment(object, optional): Environment variables
Example:
await simctlAppTool({
operation: 'launch',
udid: 'ABC-123-DEF',
bundleId: 'com.example.MyApp',
arguments: ['--verbose'],
environment: { 'DEBUG': '1' }
})terminate
Terminate running iOS app on simulator.
Parameters:
udid(string): Simulator UDIDbundleId(string): App bundle ID
Example:
await simctlAppTool({
operation: 'terminate',
udid: 'ABC-123-DEF',
bundleId: 'com.example.MyApp'
})Related Tools
simctl-device: Boot/shutdown simulatorssimctl-list: Discover simulators and their UDIDsidb-app: IDB-based app management
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| operation | Yes | ||
| udid | No | ||
| bundleId | No | ||
| appPath | No | ||
| arguments | No | ||
| environment | No |