name: simctl
binary: simctl
aliases: []
category:
- mobile
- simulator
- device
lang:
- all
platform:
- ios
- macos
summary: Apple simulator control CLI, usually invoked as `xcrun simctl`.
homepage: https://developer.apple.com/documentation/xcode/simctl
docs: https://developer.apple.com/documentation/xcode/simctl
detect:
version_args:
- help
local:
files: []
dirs:
- ios
package_json:
package_manager_prefixes: []
use_when:
- List, boot, install to, or inspect iOS simulators
avoid_when:
- A real device is required
risk:
level: high
effects:
- execute_code
- read_files
- write_files
requires_auth: false
destructive: false
confirmation_required_for:
- erasing simulators
- deleting simulator data
guardrails:
- Prefer `xcrun simctl list` before mutating simulator state.