All pages

Docs · Right-sidebar surfaces

Devices (simulators)

Availability: macOS only. Needs Xcode's simctl.

The Devices tab (right sidebar, in the More menu) lists every iOS, iPadOS, watchOS, tvOS, and visionOS simulator installed on your Mac, grouped by runtime — so you can boot, shut down, and erase devices without leaving the terminal or dropping into xcrun simctl.

Xcode (or its command-line tools) must be installed; everything here is a friendly front end over simctl.

What you can do

Per device row:

  • Boot / Shutdown — flip a simulator's state; a spinner shows while the operation is in flight.
  • Erase — factory-reset a device's contents and settings.
  • Open Simulator.app — bring up the actual simulator window for a booted device.
  • Copy UDID — one click, for scripted workflows like flutter run -d <udid> or cap run ios --target=<udid> in the pane next door.

Booted devices are marked with a pill, so the state of your fleet is readable at a glance.

Refreshing

The list loads on first open and refreshes automatically when the window becomes key again — the closest signal to "you just came back from Xcode or Simulator.app, where you probably changed something." There's also a manual refresh button that bypasses the short cache and re-queries simctl directly.

Errors

If a simctl call fails, the underlying error output appears in a banner at the top of the panel — copy-paste ready, so you don't have to re-run the command in a terminal to see what went wrong.

No simulators listed?

If the panel is empty, no simulator runtimes are installed. Run:

xcodebuild -downloadAllPlatforms

in a terminal (or install runtimes from Xcode → Settings → Platforms), then refresh.