Replay in GitHub Actions

Reality check

There is no standalone simdrive replay CLI and no packaged GitHub Action. [project.scripts] in the engine’s pyproject.toml only registers simdrive and simdrive-mcp — both start the MCP server. Replay runs through the MCP replay tool, which needs an MCP-capable agent (Claude Code or another MCP client) in the loop to invoke it:

Ask the agent, from within a CI job that has an MCP client available:
  "Replay the pr-smoke recordings against iPhone 17 / iOS 26.3 and report
   any drift."

The replay step itself doesn’t call a model — it’s a deterministic observe-and-compare pass gated by SSIM. What isn’t built yet is a way to trigger that without a live agent session, so a fully headless PR-pipeline integration (the workflow this page originally sketched) isn’t possible today. No license is required either way — SimDrive is free to install and use.

Coming soon

• A headless replay path that doesn’t require a full agent session
• Bitrise + CircleCI + self-hosted runner variants
• Caching simulator runtimes between runs
• Per-PR replay subsets (smoke vs full vs nightly)
• Failure triage workflow (drift diff PNG inline in PR comment)