SimDeckLocal iOS Simulator control plane

A project-local CLI, native daemon, browser UI, and JS test API for streaming, inspecting, and driving iOS Simulators on macOS.

Get Started

Why SimDeck?

View on GitHub

Browser-first simulator

`simdeck ui --open` starts or reuses a project daemon and opens a React UI with live WebTransport video, touch, keyboard, hardware-button, and rotation input.

Native macOS performance

A Rust HTTP server fronts an Objective-C bridge that talks to CoreSimulator, SimulatorKit, private display APIs, and HEVC or H.264 encoders.

Stable HTTP control plane

The daemon exposes simulator lifecycle, input, accessibility, logs, chrome assets, and inspector control through a single REST API.

First-class inspectors

`describe` and the UI prefer NativeScript or UIKit in-app inspectors when available, then fall back to private CoreSimulator accessibility snapshots.

Built-in extensions

A VS Code extension opens the simulator inside the editor, and `simdeck/test` gives JS/TS tests a fast API for app automation.

Local-first by default

Binds to 127.0.0.1 by default, runs without a cloud account, and can be opened to your LAN with explicit bind and advertise flags.

What you can do with SimDeck

SimDeck packages a full simulator workflow into one cross-tool surface:

Stream a Simulator into a browser tab. Run simdeck ui --open and use the same warm project daemon from the browser and CLI.
Drive Simulators from JavaScript. simdeck/test can launch apps, tap, wait for accessibility state, batch steps, and capture screenshots.
Embed a Simulator in your editor. The bundled VS Code extension opens the same surface inside a panel.
Run Simulators on your LAN. Bind to 0.0.0.0, advertise a host, and connect from any other Mac, iPad, or laptop on the network.
Replace ad-hoc simctl scripts. A single CLI handles boot, shutdown, app install/launch, URL opening, pasteboard, logs, screenshots, and UI input.

Read Architecture for a deeper tour, or jump straight into Quick Start.