agent-simulator
v0.2.0
Published
Agent-driven iOS Simulator control, screen streaming, gesture/keyboard input, accessibility dumps, and a self-building review loop — CLI.
Maintainers
Readme
agent-sim
Agent-driven iOS Simulator control from one CLI — boot/shutdown devices, stream the screen, inject taps / swipes / pinches / keyboard input, dump the accessibility tree, tail the unified log, and run a self-building review loop. No Simulator.app GUI required.
npm install -g @vinniai/agent-sim
agent-sim list
agent-sim serve # web UI on http://localhost:8421/simulatorsPlatform requirements
agent-sim is a Swift binary that links private SimulatorKit / CoreSimulator frameworks shipped with Xcode. It runs only on:
- macOS on Apple Silicon (
darwin/arm64) - Xcode 26 installed, with
xcode-selectpointing at it
npm install is platform-gated (os/cpu), and the postinstall step
downloads the matching native binary from the
GitHub release. Installs on
other platforms are skipped with a warning rather than failing.
Other install paths
Build from source — see the project README for the full CLI reference, wire protocol, and architecture docs.
License
Apache-2.0
