Skip to content

Releases: YashNaj/chauffeur

Release list

chauffeur 0.1.1

chauffeur 0.1.1 Latest
Latest

Choose a tag to compare

View all tags
@YashNaj YashNaj released this 08 Oct 22:16
v0.1.1
ca97bef

Builds with Xcode 26 again. 0.1.0 compiled only with Xcode 27, so brew install failed for anyone on Xcode 26.

brew upgrade chauffeur   # or: brew install yashnaj/chauffeur/chauffeur

The MCP bundle is unchanged; use the one from 0.1.0.

Assets 2
Loading

chauffeur v0.1.0

chauffeur v0.1.0

Choose a tag to compare

View all tags
@YashNaj YashNaj released this 08 Oct 16:05
v0.1.0
89a459f

chauffeur v0.1.0

Let your coding agent drive the iOS Simulator, and tell it the truth about what happened.

What's in it

  • Drive the iOS Simulator from a coding agent: snapshot, tap, type, scroll, wait, find, do, screenshot,
    app and device commands, logs, doctor.
  • Every action is verified: changed, NO EFFECT, INTERCEPTED, NOT DELIVERED, UNVERIFIED, APP CRASHED or APP EXITED.
  • MCP server (chauffeur mcp) and an agent skill (chauffeur skill install).
  • Heals the simulator's accessibility when an Xcode session or an early query breaks it.
  • Xcode 26 and 27, iOS 26 and 27 simulators, Apple silicon.

Benchmark

The benchmark ran 15 Simulator tasks, 3 runs each. The agent was Claude Code with either chauffeur's tools or Xcode 27's
own MCP device tools, and nothing else. The full method and every failure are in
docs/benchmark.md.

Sonnet

chauffeur Xcode 27 MCP
Tasks verified 40/45 39/45
Median cost per task $0.031 $0.222
Median turns 5.0 12.0
Median wall time 18 s 40 s
False successes 0 0

Opus

chauffeur Xcode 27 MCP
Tasks verified 45/45 39/45
Median cost per task $0.054 $0.338
Median turns 5.0 12.0
Median wall time 20 s 38 s
False successes 0 0

Install

brew install yashnaj/chauffeur/chauffeur
claude mcp add chauffeur -- chauffeur mcp      # or: chauffeur skill install
chauffeur doctor

Homebrew builds it from source, so you need Xcode and Command Line Tools that match your macOS. On macOS 27,
Homebrew refuses to build with older Command Line Tools: update them in Software Update first.

Known limits

  • Simulators only, in portrait, on Apple silicon, with Xcode 26 or 27.
  • chauffeur uses Apple's private simulator frameworks, so an Xcode update can break it. Please open an issue with
    the output of chauffeur doctor.
  • An app opened by tapping its icon, rather than with chauffeur launch, starts with its accessibility server off.
    chauffeur says to relaunch it, but doesn't relaunch it by itself yet.
  • Screen text is untrusted input: chauffeur quotes it as data, never as instructions.
Loading