tddworks/baguette

Baguette is a command line tool and web app for controlling iOS simulators on a Mac without ever opening Xcode or the Simulator app directly. It is aimed at developers and AI coding agents that need to interact with an iOS app the way a real person would, by tapping, swiping, and reading what is on screen, all from outside the simulator itself. With a single command, baguette can boot a simulator, stream its screen live at up to sixty frames per second either as an MJPEG or H.264 video feed, and inject taps, swipes, multi finger gestures, keyboard input, and hardware button presses using Apple's private SimulatorKit framework rather than any special code baked into the app being tested. It can also read out the accessibility tree of whatever is currently on screen as structured JSON, take screenshots and recordings, tail the system log, and even pipe a Mac's webcam into the simulator so a camera using app sees real video frames instead of a blank preview. The project ships with a self contained web interface, reachable by running baguette serve, which gives you a list of every simulator on the machine, a full screen focused view for controlling one device at a time, and a device farm view that shows every booted simulator side by side in a grid, useful for testing several devices at once. Everything is also scriptable from the command line, so it fits naturally into automated testing pipelines or AI agent workflows that need to drive an iOS app. Baguette is written in Swift, targets Apple Silicon Macs only, and requires Xcode 26 since it links against private frameworks that ship with that specific Xcode version. It is installed through Homebrew and comes with an extensive automated test suite covering all of its internals.