> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inspect.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# iOS Simulator debugging

> How to debug Safari and WebViews running within the iOS Simulator with Inspect

Inspect can connect to your your iOS Simulator running locally on your Mac, so you can debug and inspect Safari and other targets without connecting a physical device.

### How to enable iOS Simulator debugging

1. Install XCode and install the iOS Simulator. See [https://developer.apple.com/documentation/xcode/installing-additional-simulator-runtimes](https://developer.apple.com/documentation/xcode/installing-additional-simulator-runtimes)

2. Install the XCode Commandline Tools. See [https://mac.install.guide/commandlinetools/](https://mac.install.guide/commandlinetools/)

3. Make sure `xcrun simctl` is installed and available in your `$PATH`. You can validate this by running

```
xcrun simctl help
```

1. Open Inspect.

2. Your iOS Simulator and its debuggable targets should now show up.

3. Happy Inspecting! 🎉

## iOS Simulator FAQ

### Inspect can't find my iOS Simulator on MacOS, what do to?

Inspect uses the `simctl` utility provided by Xcode to detect and interact with iOS simulators. Follow these guides to make sure `simctl` works correctly:

* [https://nshipster.com/simctl/](https://nshipster.com/simctl/)
* [https://medium.com/xcblog/simctl-control-ios-simulators-from-command-line-78b9006a20dc](https://medium.com/xcblog/simctl-control-ios-simulators-from-command-line-78b9006a20dc)
