SimDrive

SimDrive is the MCP-native iOS automation toolkit your AI agent already knows how to drive. Hand it a Linear ticket, watch it walk the steps in the simulator (or a paired real device), and get back a deterministic recording that replays free in CI forever.

You (in Cursor / Claude Code):
  "Use simdrive to reproduce ENG-1247 — sign-in fails on iPhone 17 /
   iOS 26.3 with test@example.com."

Claude:
  → session_start({device: "iPhone 17", os_version: "26.3", bundle_id: "com.acme.app"})
  → observe()                              # screenshot + annotated marks
  → tap({text: "Email"})
  → type_text({text: "test@example.com"})
  → tap({text: "Sign In"})
  → observe()                              # error toast captured
  → record_stop({name: "ENG-1247-repro"})  # YAML+PNG attached to PR

After you ship the fix, the same recording replays free in CI — no AI cost on every run.

Why SimDrive

Bug repro in 60s

Paste the ticket, watch the agent walk it, attach the recording to the PR.

Record once, replay free

Recordings are deterministic YAML + PNG bundles. Zero AI cost on replay.

MCP-native

32 tools your agent already knows. No selectors, no custom DSL.

Real iOS device

WebDriverAgent-backed. One command bring-up per device.

Start here

Install

pip install simdrive and trial activation.

First bug

Reproduce a bug in 60 seconds.

CI replay

Wire recordings into GitHub Actions.

What is SimDrive not

Honesty up front:

• Not a record-and-replay tool you click through a UI to author. The author is your AI agent.
• Not a selector-based test framework. SimDrive uses vision + set-of-marks annotation, not XPath or accessibility IDs.
• Not a CI runner. SimDrive runs inside your CI (GitHub Actions, Bitrise, CircleCI) — bring your own runner.

License

SimDrive ships under the Elastic License 2.0. Free for internal use; prohibits offering SimDrive as a competing managed service. These docs are MIT-licensed — contributions welcome at SyncTek-LLC/simdrive-docs.