SimDeck Agent Guide

SimDeck automates iOS Simulators and Android emulators. Use the CLI for automation and the browser UI for live human visibility. iOS works with NativeScript, UIKit, SwiftUI, React Native, Expo, and Flutter apps; Android live viewing uses the emulator -share-vid shared display surface plus SimDeck's native host H.264 encoder, with lifecycle, screenshots, logs, and UIAutomator hierarchy dumps also handled through ADB.

SimDeck uses one long-running local service. Run simdeck first; it starts or reuses the background service and prints the browser URL plus pairing code. Pass --open only when you want SimDeck to open the default browser itself. Pass -p <port> or --port <port> when the service should use a non-default port. Pass -a or --autostart when the service should also be registered as a macOS LaunchAgent.

Example response from simdeck: