Skip to content
Back to search

baguette

MarketplaceWorks with Claude CodeGitHub

Baguette — headless iOS simulator control for Claude Code

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/tddworks/baguette with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/tddworks/baguette'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tddworks--baguette/badge.svg)](/listings/tddworks--baguette)

HTML

<a href="/listings/tddworks--baguette"><img src="/api/listings/tddworks--baguette/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

brew install baguette

Apple Silicon with Xcode 26 — `baguette` links the private SimulatorKit / CoreSimulator frameworks that ship with Xcode. If Homebrew complains about Rosetta, see [Troubleshooting](CONTRIBUTING.md#troubleshooting-the-homebrew-install).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 23 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "baguette",
  3. "description": "Baguette — headless iOS simulator control for Claude Code",
  4. "owner": {
  5. "name": "tddworks"
  6. },
  7. "plugins": [
  8. {
  9. "name": "baguette",
  10. "source": "./",
  11. "description": "Drive iOS simulators programmatically via the baguette CLI — taps, swipes, multi-finger gestures, hardware buttons, keyboard, and frame capture without opening Xcode.",
  12. "version": "0.1.75",
  13. "author": {
  14. "name": "tddworks",
  15. "url": "https://github.com/tddworks"
  16. },
  17. "homepage": "https://tddworks.github.io/baguette/",
  18. "license": "Apache-2.0",
  19. "category": "development",
  20. "keywords": ["ios", "simulator", "automation", "testing", "agent"]
  21. }
  22. ]
  23. }
README.md · README · 120 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img src="assets/logo.png" alt="Baguette" width="240">
  3. </p>
  4. <h1 align="center">Baguette</h1>
  5. <p align="center"><em>Bon appétit.</em></p>
  6. <p align="center">
  7. Headless iOS Simulator manager + host-side input injection for iOS 26.
  8. </p>
  9. <p align="center">
  10. <a href="https://github.com/tddworks/baguette/actions/workflows/ci.yml"><img src="https://github.com/tddworks/baguette/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
  11. <a href="https://codecov.io/gh/tddworks/baguette"><img src="https://codecov.io/gh/tddworks/baguette/branch/main/graph/badge.svg" alt="Coverage"></a>
  12. <a href="https://github.com/tddworks/baguette/releases/latest"><img src="https://img.shields.io/github/v/release/tddworks/baguette?sort=semver" alt="Latest release"></a>
  13. <a href="LICENSE"><img src="https://img.shields.io/github/license/tddworks/baguette" alt="License"></a>
  14. <img src="https://img.shields.io/badge/Swift-6.1-orange?logo=swift" alt="Swift 6.2">
  15. <img src="https://img.shields.io/badge/macOS-15%2B-blue?logo=apple" alt="macOS 15+">
  16. <img src="https://img.shields.io/badge/Xcode-26-1575F9?logo=xcode" alt="Xcode 26">
  17. </p>
  18. A single Swift CLI — **`baguette`** — plus a self-contained web UI that
  19. gives you full headless control of an iOS simulator without opening
  20. Xcode or `Simulator.app`. Boot devices, stream their screens at 60 fps,
  21. dispatch taps, swipes, multi-finger and system gestures, keyboard and
  22. hardware buttons, read the accessibility tree, tail the unified log,
  23. take screenshots and recordings, and feed the simulator a camera,
  24. a location, motion and a slower network — on iOS 26 and later, where
  25. the 5-argument HID call `idb` and `AXe` rely on stopped working.
  26. ## Demo
  27. https://github.com/user-attachments/assets/e904413f-16bb-4b3d-86d5-162333403cee
  28. https://github.com/user-attachments/assets/c49c9f4b-0e4b-47ea-9272-3223b1ac7739
  29. https://github.com/user-attachments/assets/65dc62ee-f0c7-48fb-9c57-5bd267c8c02f
  30. > The raw clip lives at [`assets/demo.mp4`](assets/demo.mp4) — drag
  31. > it into a GitHub web edit of this README to upload as a CDN-hosted
  32. > video and replace the line above with the auto-generated URL.
  33. ## Install
  34. ```bash
  35. brew install baguette
  36. ```
  37. Apple Silicon with Xcode 26 — `baguette` links the private SimulatorKit /
  38. CoreSimulator frameworks that ship with Xcode. If Homebrew complains about
  39. Rosetta, see [Troubleshooting](CONTRIBUTING.md#troubleshooting-the-homebrew-install).
  40. ## Quick start
  41. ```bash
  42. baguette serve # web UI at http://127.0.0.1:8421/simulators
  43. open http://localhost:8421/farm # every booted simulator side by side
  44. baguette list
  45. baguette boot --udid <UDID>
  46. baguette tap --udid <UDID> --x 219 --y 478 --width 438 --height 954
  47. baguette describe-ui --udid <UDID> # what's on screen, frames in device points
  48. # an App Store-sized screenshot, and a 10-second clip at the same size
  49. baguette screenshot --udid <UDID> --size appstore-6.9 --output hero.png
  50. baguette record --udid <UDID> --size appstore-6.9 --duration 10 --output demo.mp4
  51. ```
  52. Coordinates are device points, and `--width` / `--height` are the screen
  53. size in points (`baguette chrome layout --udid <UDID>` tells you). For a
  54. long-lived session, pipe JSON gestures into `baguette input` — see the
  55. [wire protocol](docs/wire.md).
  56. ## Sponsors
  57. Apps that use and support Baguette development:
  58. <table>
  59. <tbody>
  60. <tr>
  61. <td width="160" align="center">
  62. <a href="https://air.build" target="_blank">
  63. <img width="64" src="https://air.build/images/products/airbuild.svg" alt="AirBuild"/>
  64. <br>
  65. <b>AirBuild</b>
  66. </a>
  67. </td>
  68. <td>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.</td>
  69. </tr>
  70. </tbody>
  71. </table>
  72. ## What it covers
  73. | Area | What you can do |
  74. |---|---|
  75. | Touches & gestures | Tap, swipe, pinch, pan, streamed one- and two-finger touches, home-indicator and pull-down system gestures → [touches](docs/features/touches/README.md), [double-tap](docs/features/double-tap/README.md) |
  76. | Buttons & keyboard | Home, lock, volume, action, Watch crown; keystrokes, typed text, paste and clipboard sync → [buttons](docs/features/buttons/README.md), [keyboard](docs/features/keyboard/README.md), [paste](docs/features/paste/README.md) |
  77. | Screen capture | Screenshots, recordings, frame streams to stdout, one output-size vocabulary, 3D device renders → [screenshot](docs/features/screenshot/README.md), [stream](docs/features/stream/README.md), [recording](docs/features/recording/README.md), [capture-size](docs/features/capture-size/README.md), [3d-rendering](docs/features/3d-rendering/README.md) |
  78. | Accessibility | The on-screen AX tree as JSON, hit-testing, a hover inspector in the browser → [accessibility](docs/features/accessibility/README.md), [ax-inspector](docs/features/ax-inspector/README.md), [ax-hit-test-sweep](docs/features/ax-hit-test-sweep/README.md) |
  79. | Logs | Live unified log, filtered by level, predicate or bundle id → [logs](docs/features/logs/README.md) |
  80. | Web UI | Focus-mode page with bezel, a multi-device farm, a JS SDK for your own page → [device-farm](docs/features/device-farm/README.md), [chrome-bezel](docs/features/chrome-bezel/README.md), [baguette-sdk](docs/features/baguette-sdk/README.md), [serve routes](docs/serve.md) |
  81. | Device lifecycle | Boot, shut down, repair input after Xcode 27's Device Hub → [boot](docs/features/boot/README.md), [device-hub](docs/features/device-hub/README.md) |
  82. | Device settings | Orientation, appearance, contrast, text size, status bar, shake → [orientation](docs/commands.md#baguette-orientation), [interface](docs/features/interface/README.md), [status-bar](docs/features/status-bar/README.md), [shake](docs/features/shake/README.md) |
  83. | Simulated world | Mac webcam or a file as the camera, GPS and routes, CoreMotion, network conditioning → [camera](docs/features/camera/README.md), [location](docs/features/location/README.md), [motion](docs/features/motion/README.md), [network](docs/features/network/README.md) |
  84. | Apps & files | Deep links and URL schemes, drag-and-drop app install and Photos → [deep-links](docs/features/deep-links/README.md), [file-upload](docs/features/file-upload/README.md) |
  85. | Other screens | CarPlay and paired Watch, iPhone Duo and its hinge, a physical iPhone (preview) → [companion-screens](docs/features/companion-screens/README.md), [iphone-duo](docs/features/iphone-duo/README.md), [hinge](docs/features/hinge/README.md), [device-twin](docs/features/device-twin/README.md) |
  86. | Plugins | Add panels and commands from a trusted bakery; they run as subprocesses → [plugins](docs/features/plugins/README.md) |
  87. ## More
  88. [Docs index](docs/README.md) · [Commands](docs/commands.md) ·
  89. [Wire protocol](docs/wire.md) · [Serve routes](docs/serve.md) ·
  90. [Architecture](docs/ARCHITECTURE.md) · [Contributing](CONTRIBUTING.md) ·
  91. [Changelog](CHANGELOG.md)
  92. ## License
  93. Apache License 2.0 — see [`LICENSE`](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.