Bon appétit.
Drive iOS simulators, real iPhones and Android emulators from one CLI and one browser page.
A single Swift CLI — baguette — plus a self-contained web UI that
drives your devices headless, without opening Xcode, Simulator.app or
Android Studio: one --udid, the same commands and page for every device,
and one that can't do something says so by name and exits 1.
- iOS simulators — everything below: boot them, stream their screens
at 60 fps, dispatch taps, swipes, multi-finger and system gestures,
keyboard and hardware buttons, read the accessibility tree, tail the
unified log, take screenshots and recordings, and feed them a camera,
a location, motion and a slower network — on iOS 26 and later, where
the 5-argument HID call
idbandAXerely on stopped working. - Real iPhones on a cable — touches, a live screen, screenshots, recordings, the pasteboard and the accessibility tree, through CoreDevice → real devices.
- Android emulators — boot and shut down an AVD, stream its screen,
touches with two fingers, scrolls, buttons (
backtoo), keys and typing, through the emulator's own control API → Android.
demo.mp4
device-farm-demo.mp4
Recording.at.2026-05-04.13.20.02.2.mov
brew install baguetteApple Silicon with Xcode 26 — baguette links the private SimulatorKit /
CoreSimulator frameworks that ship with Xcode. If Homebrew complains about
Rosetta, see Troubleshooting.
- A real iPhone needs to be paired with Xcode, in Developer Mode, on the cable, unlocked, with its developer disk image mounted.
- Android emulators need the Android SDK's
adbandemulator:$ANDROID_HOME,$ANDROID_SDK_ROOTor Android Studio's~/Library/Android/sdk.
git clone https://github.com/tddworks/baguette && cd baguette
swift run Baguette serve # Swift 6.4; builds, then serves http://127.0.0.1:8421
swift run Baguette list # any command runs the same wayThe rest of development is in CONTRIBUTING.
baguette serve # web UI at http://127.0.0.1:8421/simulators
open http://localhost:8421/farm # every booted simulator side by side
baguette list # simulators, iPhones on a cable, Android emulators
baguette boot --udid <UDID>
baguette tap --udid <UDID> --x 219 --y 478 --width 438 --height 954
baguette describe-ui --udid <UDID> # what's on screen, frames in device points
# the same commands on other devices: an iPhone's UDID, an emulator's AVD name
baguette screenshot --udid 00008160-… --output phone.jpg
baguette boot --udid Pixel_9 # starts the AVD headless
baguette tap --udid Pixel_9 --x 206 --y 458 --width 412 --height 915
# an App Store-sized screenshot, and a 10-second clip at the same size
baguette screenshot --udid <UDID> --size appstore-6.9 --output hero.png
baguette record --udid <UDID> --size appstore-6.9 --duration 10 --output demo.mp4Coordinates are device points (dp on Android), and --width / --height
are the screen size in those points (baguette chrome layout --udid <UDID>
tells you for a simulator). For a
long-lived session, pipe JSON gestures into baguette input — see the
wire protocol.
Apps that use and support Baguette development:
|
AirBuild |
Your idea. Your AI team. A working native iOS app. Build the app. AirBuild handles App Review. Specialized agents submit, respond, fix, and resubmit—automatically. |
Rows below are for simulators; other devices do the parts their pages list.
| Area | What you can do |
|---|---|
| Devices | iOS simulators, real iPhones on a cable, Android emulators; all in one list and one page → real devices, Android, serve |
| Touches & gestures | Tap, swipe, pinch, pan, streamed one- and two-finger touches, home-indicator and pull-down system gestures → touches, double-tap |
| Buttons & keyboard | Home, lock, volume, action, Watch crown; keystrokes, typed text, paste and clipboard sync → buttons, keyboard, paste |
| Screen capture | Screenshots, recordings, frame streams to stdout, one output-size vocabulary, 3D device renders → screenshot, stream, recording, capture-size, 3d-rendering |
| Accessibility | The on-screen AX tree as JSON, hit-testing, a hover inspector in the browser → accessibility, ax-inspector, ax-hit-test-sweep |
| Logs | Live unified log, filtered by level, predicate or bundle id → logs |
| Web UI | Focus-mode page with bezel, a multi-device farm, a JS SDK for your own page → device-farm, chrome-bezel, baguette-sdk, serve routes |
| Device lifecycle | Boot, shut down, repair input after Xcode 27's Device Hub → boot, device-hub |
| Device settings | Orientation, appearance, contrast, text size, status bar, shake → orientation, interface, status-bar, shake |
| Simulated world | Mac webcam or a file as the camera, GPS and routes, CoreMotion, network conditioning → camera, location, motion, network |
| Apps & files | Deep links and URL schemes, drag-and-drop app install and Photos → deep-links, file-upload |
| Other screens | CarPlay and paired Watch, iPhone Duo and its hinge, a cable-free iPhone mirrored over Wi-Fi (preview) → companion-screens, iphone-duo, hinge, device-twin |
| Plugins | Add panels and commands from a trusted bakery; they run as subprocesses → plugins |
Docs index · Commands · Wire protocol · Serve routes · Architecture · Contributing · Changelog
Apache License 2.0 — see LICENSE.
