애플 시뮬레이터의 npx serve.

Codex, Cursor, Claude Desktop 같은 에이전트 도구와 함께 시뮬레이터를 호스팅할 수 있습니다 — 로컬, LAN을 통해, 또는 원격 맥에서 호스팅하여 어디서든 터널링할 수 있습니다.

https://github.com/user-attachments/assets/fbf890f4-c8c7-4684-82be-d677b8a188f8

serve-sim는 simctl io를 통해 시뮬레이터의 프레임버퍼를 캡처하고, MJPEG 스트림 + WebSocket 제어 채널로 노출하며, React 미리보기 UI를 제공하는 작은 Swift 헬퍼를 생성합니다. 부팅된 모든 iOS 시뮬레이터에서 작동하며, Xcode 플러그인이나 앱에 인스트루멘테이션이 없습니다.

특징

• 브라우저에서 60 FPS 전체 비디오 스트림.
• 아래에서 스와이프하면 집에 가.
• 옵션 키를 누르고 있으면 핀치(pinch) 같은 제스처가 있어 줌을 할 수 있습니다.
• 시뮬레이터 로그가 브라우저로 전달되어 브라우저 사용 MCP 도구가 읽을 수 있습니다.
• 최근 시뮬레이터 동작은 브라우저 도구 패널과 serve-sim event-log에서 확인할 수 있습니다.
• 비디오와 이미지를 드래그 앤 드롭하여 시뮬레이터 장치에 추가합니다.
• 키보드 명령과 단축키가 시뮬레이터로 전달되며, CMD+SHIFT+H를 포함해 집으로 이동할 수 있습니다.
• Apple Watch, iPad, iOS 지원.

왜?

serve-sim

The npx serve of Apple Simulators.

Host your simulator for use with Agent tools like Codex, Cursor, or Claude Desktop — locally, over your LAN, or host on a remote mac and tunnel anywhere.

npx serve-sim
# → Preview at http://localhost:3200

https://github.com/user-attachments/assets/fbf890f4-c8c7-4684-82be-d677b8a188f8

serve-sim spawns a small Swift helper that captures the simulator’s framebuffer via simctl io, exposes it as an MJPEG stream + WebSocket control channel, and serves a React preview UI on top. It works with any booted iOS Simulator — no Xcode plugin, no instrumentation in your app.

Features

• Full 60 FPS video stream in the browser.
• Swipe from the bottom to go home.
• gestures like pinch to zoom by holding the option key.
• Simulator logs are forwarded to the browser for browser-use MCP tools to read from.
• Recent simulator actions are available in the browser tools panel and serve-sim event-log.
• Drag and drop videos and images to add them to the simulator device.
• Keyboard commands and hot keys are forwarded to the simulator, including CMD+SHIFT+H to go home.
• Apple Watch, iPad, and iOS support.

Why?

Hosted simulators can be hard to test, serve-sim enables you to test the hosted infra locally first for faster iteration. When you’re ready to host a simulator remotely, simply tunnel the served URL and users can interact with the simulator as if it were running locally on their device.

I develop the Expo framework, but this tool is completely agnostic to React Native and can be used for any iOS interaction you need.

Install

Requires macOS with Xcode command line tools (xcrun simctl) and a maintained Node.js LTS release (currently Node 20+). Older or end-of-life Node versions are not supported. bun is not required to run the CLI. Camera injection uses a host-side helper built for macOS 14+.

Note: Apple Silicon (arm64) only. The bundled serve-sim-bin helper ships as an arm64 binary and does not run on Intel (x86_64) Macs.

Xcode 27 keyboard input: Device Hub must be running with the target simulator window visible and frontmost. macOS may also require the app that launched serve-sim (for example Terminal) to be enabled in System Settings → Privacy & Security → Accessibility. Xcode 26 and older keep using the legacy simulator HID path. Set SERVE_SIM_DISABLE_DEVICE_HUB_KEYBOARD=1 to opt out of the Xcode 27 bridge.

iPhone Duo

With Xcode 27.1 and the iOS 27.1 runtime, the preview exposes Closed, Book, and Open controls for iPhone Duo. Selecting one drives the simulator’s hinge and follows the active panel’s framebuffer. Touches use the panel’s own integrated digitizer; volume and power controls use a guest HID service.

serve-sim fold 0 -d 
serve-sim fold 180 -d       # flat, 180°
serve-sim fold 130 -d       # 130°
serve-sim fold 100 -d