Baguette CLI
Baguette CLI saves iOS Simulator screenshots and recordings for review while an agent runs tests without a Simulator.app window.
- 2,282 ★ on the repository
- Last commit
- Apache-2.0
Extended access
Why this level
- The CLI controls simulators, input and local files; optional plugins run on the host.
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/baguetteDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The CLI controls simulators, input and local files; optional plugins run on the host.
This is third-party code. Review the repository files before installing.
What it does
Baguette CLI controls iOS Simulator devices through commands and a local web interface. Users select a simulator by UDID, send touches or text and read the accessibility tree. The UI description includes element frames for the agent to check before its next tap. Input coordinates use device points, so screenshot pixel dimensions cannot be substituted directly. Recordings, logs and simulated device conditions support testing, including changes to location, orientation, appearance and text size.
Who it is for. iOS test engineers needing programmable input and reproducible simulator captures from the terminal.
Good fit when
- A tester repeats an iOS scenario without manually driving the simulator window.
- A designer receives a screenshot at a specified size for review.
- The team reproduces behavior under changed GPS, motion or slow networking.
- During a test, you watch several devices in one local dashboard.
Not a fit when
- The host is an Intel Mac or lacks the required Xcode setup.
- You need a complete replacement for physical-device testing.
- The target is Android or another platform outside iOS Simulator.
Example request
Boot the test iPhone simulator, open app settings and save a screenshot. Inspect the UI tree before gestures.Limitations
Installation targets Apple Silicon with Xcode 26 and links Xcode’s private SimulatorKit and CoreSimulator frameworks. Main input support targets iOS 26 and later, so check compatibility when upgrading the environment. Coordinates use device points rather than screenshot pixels, which matters for accurate input. Plugins execute as host subprocesses, so install only explicitly reviewed and trusted extensions.
How to disable. Stop the Baguette web server and unused simulators, then uninstall through Homebrew while retaining needed captures.
FAQ
How do I open the web UI?
Run `baguette serve` and open the address printed by the command. The local panel uses port 8421 by default.
How do I choose a device?
Use `baguette list`, then supply the intended UDID.
How do I inspect UI elements?
Run `baguette describe-ui --udid <UDID>` with the device identifier. It returns the UI tree and element frames for selecting a tap target.
Which units do coordinates use?
Device points. Obtain layout dimensions rather than guessing from screenshot pixels.
Can I record a short clip?
Yes. Set duration, size and output for `record`, then review the capture.
Discussion
No questions or reviews yet.
Related
CLI toolsA CLI that shows an agent an iOS Simulator or Android emulator screen as a compact element list and taps elements by short alias.
The npx serve-sim command streams an iOS Simulator to the browser and lets an agent tap, swipe, type and replace the camera feed
A plugin and MCP server that give an agent annotations on the iOS Simulator screen: element, screen, search strings, two shots.
A DeepSeek Harness plugin: iOS Simulator and a USB iPhone inside the chat, with 22 tools to drive them
An MCP server for the iOS Simulator: taps, swipes, text input, accessibility tree, screenshots, video and app control
A skill with scripts for building iOS apps and driving the simulator through the accessibility tree, with compact output for agents
README in short
Additional controls change orientation, appearance and text size. Deep links and companion screens are supported.