Cursor iOS Simulator Not Opening? Here Is the Fix

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, 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:

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:

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 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 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 and the Xcode command PhaseScriptExecution failed error.

Sources

• Apple Xcode documentation: the official toolchain for building and signing iOS apps.
• React Native architecture overview: how React Native renders real native views.
• Expo EAS Build documentation: 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.