Skip to main content
Back

Expo's serve-sim Turns Your iOS Simulator Into a Live Browser URL

serve-sim streams any booted iOS Simulator to the browser over MJPEG, giving AI agents like Codex and Cursor a live, interactive window into your app with one npx command

Repo, Full Access
  • serve-sim streams any booted iOS Simulator to the browser as a live MJPEG feed with full touch/gesture control via one npx serve-sim command — GitHub
  • OpenAI's Build iOS Apps plugin for Codex uses serve-sim as its live simulator streaming engine, enabling write-run-fix loops without leaving the agent
  • Works with Claude Code, Cursor, Codex CLI, and Gemini CLI via an installable Agent Skill that teaches agents to drive taps, gestures, rotation, and camera injection
  • Streams at 60 FPS with forwarded keyboard shortcuts, drag-and-drop media, simulator log streaming, and multi-device support for iPhone, iPad, and Apple Watch
  • No Xcode plugin or app instrumentation required — captures the framebuffer directly via simctl io using a small compiled Swift helper binary
  • Limitations: macOS-only, no Android emulator support, and remote/tunneled use may introduce latency and input fidelity issues

serve-sim is a new open-source CLI from Expo core contributor Evan Bacon that does something deceptively simple: it turns your local iOS Simulator into a URL. One command, and any browser, AI agent, or teammate can watch, tap, swipe, and interact with your running app in real time. No Xcode plugin. No changes to your app. No screen sharing.

The problem it actually solves

Most simulator tooling is built for the developer sitting at the same Mac. serve-sim treats Apple simulators like a network service that browsers, agents, and remote teammates can interact with in real time. That shift matters enormously in 2026, where AI coding agents need to see the app they are editing to close the feedback loop.

serve-sim removes the usual friction around simulator inspection. You do not need an Xcode plugin, you do not need to instrument your app, and you do not need to screen-share a developer desktop just to let an agent or teammate interact with the device.

How it works under the hood

serve-sim spawns a small Swift helper that captures the simulator's framebuffer via simctl io, exposes it as an MJPEG stream plus a 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.

MJPEG (Motion JPEG) is a video format where each frame is a separate JPEG image sent over HTTP , it is universally readable by any browser without codec negotiation. The WebSocket channel is a separate, bidirectional connection that carries input events back to the simulator. The two channels are intentionally split: the video stream stays fast and stateless, while the control plane handles taps, swipes, and key presses without interfering with the frame rate.

serve-sim uses a small Swift helper binary to talk to the simulator through simctl io, then publishes the framebuffer as an MJPEG stream and the input surface as a WebSocket channel. The CLI wraps that binary, manages per-device sessions, and stores session state in $TMPDIR/serve-sim/