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 the same way every time.

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, ask the agent to replay the same recording to confirm it still fails (or now passes) before deploy.

Why SimDrive

Bug repro in 60s

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

Record once, replay anytime

Recordings are deterministic YAML + PNG bundles you can replay later via the replay tool.

MCP-native

36 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 — no license or account required.

First bug

Reproduce a bug in 60 seconds.

Replaying recordings

How replay works today, and what a CI runner would need.

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. There’s no standalone replay CLI today — replay runs through the MCP replay tool from within an agent session. See Replaying recordings.

Need help?

Email support@simdrive.dev, file an issue on GitHub, or browse Troubleshooting. Full support options at simdrive.dev/support.

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.