nativescript/simdeck

SimDeck is a developer tool for controlling iOS Simulators and Android emulators from the command line on macOS, with a focus on making mobile app development work smoothly with AI coding agents. Instead of manually tapping through a simulator GUI, you can script or automate every interaction, taps, swipes, typing, screenshots, video recording, app installs, and more, using a command-line interface or a JavaScript/TypeScript testing library. The core idea is that an AI agent (like Codex or Claude) working on your mobile app needs to be able to "see" the simulator screen and interact with it programmatically. SimDeck provides a real-time screen description command that reads the app's accessibility tree (the structured list of buttons, labels, and other elements on screen) and formats it efficiently for AI consumption. It also streams live simulator video over a browser-based video protocol, so you can watch the simulator in a browser window or inside VS Code without launching the full Simulator app. It supports multiple mobile frameworks including NativeScript, React Native, Flutter, SwiftUI, and UIKit, and provides runtime inspector plugins for each to let you inspect the live view hierarchy of running apps. On the performance side, it can display real-time CPU, memory, disk, network, and hang data for simulator processes. Typical use cases include running automated tests against a simulator as part of a CI/CD pipeline, giving an AI coding agent the ability to interact with and verify changes in a running mobile app, and debugging app layout or behavior without manually touching the simulator. The full README is longer than what was provided.