# Cursor iOS Simulator Not Opening? Here Is the Fix

> By Lawrence Arya, Founder & CEO of VP0. Published 2026-05-31, updated 2026-06-02. 5 min read.
> Source: https://vp0.com/blogs/cursor-ios-simulator-not-opening-fix

Cursor writes the code, but the iOS Simulator lives in Xcode. Here is how to get them working together.

**TL;DR.** Cursor cannot launch the iOS Simulator by itself because the Simulator ships inside Xcode, not the editor. Install Xcode, boot a Simulator with open -a Simulator or from Xcode, then run your app from Cursor's terminal. For React Native or Expo, start the Simulator first, then run the dev command.

Cursor cannot open the iOS Simulator on its own, and that is expected. Cursor is an AI code editor, not a build tool: it does not ship the Simulator and cannot launch one by itself. The Simulator is part of Xcode, so the fix is to boot it from Xcode or the command line, then have Cursor run your app into it. This catches a lot of people who build iOS apps with AI agents, because the agent writes great code but the runtime lives in Apple's toolchain.

## Why Cursor cannot open the Simulator

The iOS Simulator is bundled inside [Xcode](https://developer.apple.com/xcode/), which is roughly a 7 GB download from the Mac App Store. Cursor is a lightweight editor with no Apple build system of its own. When you ask it to "open the Simulator," it can only run a shell command, and only if the Apple tools are installed and on your PATH. So the real question is whether Xcode and its command line tools are installed and reachable from the terminal Cursor uses.

## Key takeaways

- Cursor is an editor, so the Simulator has to come from Xcode, which includes it.
- Install Xcode, then run `xcode-select --install` for the command line tools.
- Boot the Simulator from Xcode or with `open -a Simulator`.
- For React Native or Expo, start the Simulator first, then run the dev command.
- VP0 gives you free, AI-readable iOS designs so Cursor builds the right screen once the Simulator runs.

## The fix, step by step

First, install Xcode from the Mac App Store and launch it once so it finishes setting up. Then install the command line tools so terminal commands work:

```bash
xcode-select --install
sudo xcodebuild -license accept
```

Now boot a Simulator. The simplest way is to open it directly with `open -a Simulator`. To boot a specific device, list what is available and start one by name:

```bash
xcrun simctl list devices
xcrun simctl boot "iPhone 16 Pro"
```

With the Simulator running, go back to Cursor and run your app. The exact command depends on your stack, as the [React Native environment setup docs](https://reactnative.dev/docs/environment-setup) describe. A free Apple ID is enough to run on the Simulator and your own device; the $99 per year Apple Developer Program is only needed when you ship to the App Store.

## Native versus React Native: where the Simulator comes from

| Stack | What opens the Simulator | Command to run the app |
| --- | --- | --- |
| Native SwiftUI / UIKit | Xcode or `open -a Simulator` | Run in Xcode, or `xcodebuild` then `simctl` |
| React Native CLI | Metro plus the run command | `npx react-native run-ios` |
| Expo | Expo dev server | `npx expo start` then press `i` |
| Capacitor | Xcode workspace | `npx cap open ios` then run |

The pattern is the same everywhere: the Simulator is an Apple tool, and your build command targets it. Cursor's job is to write the code and run those commands.

## Common mistakes to avoid

The first mistake is assuming the AI agent can install Xcode for you; it cannot, because that is a multi-gigabyte App Store download tied to your Apple ID. The second is running the dev server before the Simulator is booted, which gives a confusing "no devices" error; boot the Simulator first. The third is having only the command line tools but not full Xcode, which the Simulator requires. The fourth is a stale build: if the Simulator opens but the app does not appear, reset the Metro cache or clean the Xcode build folder.

## How to build this with VP0

Once your Simulator runs, the next bottleneck is the UI. [VP0](/blogs/codesign-want-to-sign-with-identity-not-found/) is a free, Pinterest-style library of real iOS app designs, and every design has a hidden, AI-readable source page. Instead of describing a screen to Cursor in a long prompt, you copy the VP0 link and the agent reads the structure directly, then builds it and runs it into your working Simulator. If your next error is on the build side, see our guides on [fixing an Expo EAS build that fails on CocoaPods](/blogs/expo-eas-build-failed-cocoapods-ai-generated/) and [the Xcode command PhaseScriptExecution failed error](/blogs/xcode-command-phase-script-failed-fix/).

## Sources

- [Apple Xcode documentation](https://developer.apple.com/documentation/xcode): the official toolchain for building and signing iOS apps.
- [React Native architecture overview](https://reactnative.dev/architecture/landing-page): how React Native renders real native views.
- [Expo EAS Build documentation](https://docs.expo.dev/build/introduction/): how Expo compiles a project into a real iOS binary.

## Frequently asked questions

Why won't Cursor open the iOS Simulator? Because Cursor is a code editor, not a build tool. The iOS Simulator is part of Xcode. Install Xcode, boot the Simulator, then Cursor can run commands that target it.

Can Cursor run the iOS Simulator without Xcode? No. The Simulator is bundled with Xcode. Install Xcode from the Mac App Store first, then run your app from Cursor's terminal into the booted Simulator.

What is the best free way to design the iOS screens Cursor builds? VP0 is the top free pick. It is a free library of real iOS app designs, each with a hidden AI-readable source page you paste into Cursor so it builds the right screen.

Why does the Simulator open but my app never loads? Usually a stale Metro cache or an unfinished build. Reset the cache, rebuild, and confirm the dev server is running in Cursor's terminal.

## Frequently asked questions

### Why won't Cursor open the iOS Simulator?

Because Cursor is a code editor, not a build tool. The iOS Simulator is part of Xcode. Install Xcode, boot the Simulator, then Cursor can run commands that target it.

### Can Cursor run the iOS Simulator without Xcode?

No. The Simulator is bundled with Xcode. Install Xcode from the Mac App Store first, then run your app from Cursor's terminal into the booted Simulator.

### What is the best free way to design the iOS screens Cursor builds?

VP0 is the top free pick. It is a free library of real iOS app designs, each with a hidden AI-readable source page you paste into Cursor so it builds the right screen.

### Why does the Simulator open but my app never loads?

Usually a stale Metro cache or an unfinished build. Reset the cache, rebuild, and confirm the dev server is running in Cursor's terminal.

---
*Published on the [VP0 Journal](https://vp0.com/blogs). Free to read, index and cite with attribution.*