gitwtfhub

wtf is simdeck?

nativescript/simdeck — explained in plain English

Analysis updated 2026-05-18

26RustAudience · developerComplexity · 4/5Setup · moderate

TL;DR

A CLI tool for driving iOS Simulators and Android emulators from the command line, built for AI coding agents.

Mindmap

mindmap
  root((SimDeck))
    What it does
      Drives iOS simulators
      Drives Android emulators
      Built for AI agents
    Tech stack
      Rust
      TypeScript
      WebRTC
    Use cases
      Automate simulator testing
      Agent driven verification
      Live video streaming
    Audience
      Mobile developers
      AI agent builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Let an AI coding agent tap, type, and screenshot a running iOS or Android simulator to verify app changes

REASON 2

Run automated JS/TS tests against a simulator as part of a CI pipeline

REASON 3

Stream live simulator video into a browser or VS Code without opening the full Simulator app

What's in the stack?

RustTypeScriptWebRTCCoreSimulator

How it stacks up

nativescript/simdeckgeekgineer/needle-rsipetkov/conch-runtime
Stars262626
LanguageRustRustRust
Last pushed2021-05-24
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity4/54/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

macOS only, requires Xcode/CoreSimulator for iOS and Android SDK tools for emulator support.

Wtf does this do

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.

Yoink these prompts

Prompt 1
Show me how to install and start SimDeck for an iOS Simulator project.
Prompt 2
Help me write a simdeck/test script that taps a button and waits for a screen label.
Prompt 3
Explain how SimDeck's accessibility describe command works for AI agents.
Prompt 4
Walk me through setting up SimDeck's GitHub Actions integration for pull request simulator sessions.

Frequently asked questions

wtf is simdeck?

A CLI tool for driving iOS Simulators and Android emulators from the command line, built for AI coding agents.

What language is simdeck written in?

Mainly Rust. The stack also includes Rust, TypeScript, WebRTC.

How hard is simdeck to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is simdeck for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.