SimMirror
Mirror and drive iOS Simulators and real iPhones from Claude Code, CLI agents and the browser.
에이전트 강화
게시자의 자체 명령입니다. PlugMCP 엔드포인트가 아닙니다.
Host a copy with our keys and logs.
uvx sim-mirror==3.7.0Claude Code에는 로컬 명령용 설치 링크가 없습니다. 아래 명령을 복사해 터미널에서 실행합니다.
claude mcp add io.github.andrewkochulab-sim-mirror -- uvx sim-mirror==3.7.0터미널에서 실행합니다.
{ "mcpServers": { "io.github.andrewkochulab-sim-mirror": { "command": "uvx", "args": [ "sim-mirror==3.7.0" ] } }}claude_desktop_config.json
원격 URL인가요, 내 컴퓨터에서 실행하는 명령인가요? 두 설치 방식의 차이
PlugMCP에서 실행
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
실행A real session, sped up four times. The whole recording runs 1m 39s.
A live iOS Simulator -- or your own iPhone, over its cable -- in any browser tab or web page, an animated cursor that shows exactly what your AI agent is about to tap, and token-efficient UI snapshots so agents read the screen as compact text instead of screenshots. Record any screen as an MP4 or a GIF for a pull request. Works with Claude Code, Codex, Cursor and any other MCP client.
Status: 2.1. The agent tools, the viewer, the protocol and the embedding API are stable, and a check holds every release to what SimMirror promises not to break. 2.0 brought real iPhones and iPads beside the simulators -- live over the cable, driven through WebDriverAgent -- and records any screen as an MP4 or a GIF. 2.1 reads and touches apps turned to landscape, keeps taps off what a tab bar covers, builds the worktree the agent works in, and adds observe mode for walkthroughs on accounts an agent must not change. It removes nothing 1.x promised.
<sim-mirror> web
component, with touch, scrolling, typing, hardware buttons and light and dark mode.Claude Code, with the plugin (tools, a skill that teaches snapshot-first use, and /sim-mirror:open):
/plugin marketplace add AndrewKochulab/sim-mirror
/plugin install sim-mirror@sim-mirror
Any MCP client, as a stdio server:
claude mcp add sim-mirror -- uvx --from sim-mirror==2.1.0 sim-mirror mcp
Configurations for Codex, Cursor and other clients.
The command, for sim-mirror open, doctor and the rest:
uv tool install sim-mirror==2.1.0
# or
brew install andrewkochulab/tap/sim-mirror
The viewer library, for your own pages: npm install @andrewkochulab/sim-mirror
(npm). SimMirror itself is
on PyPI and in a Homebrew tap.
Requirements: an Apple Silicon Mac, Xcode 26 or later, and uv or Homebrew. Nothing else: SimMirror drives a simulator with its own helper, which comes in the package. A real iPhone needs Developer Mode, and an Apple development team to be touched. Details in Installation.
sim-mirror doctor # check this Mac, ending with a real tap on a simulator
sim-mirror open # this project's simulator, live in a browser tab
Then ask your agent:
Open Settings → General → About and tell me which iOS version this simulator runs. Use sim_snapshot rather than screenshots.
With an iPhone plugged in, unlocked and in Developer Mode:
Switch to my iPhone, build and run the app on it, walk through sign-up and record it as a GIF.
The first time, press Set up touch in the viewer: it builds WebDriverAgent with your project's own signing team.
Getting started explains what happens along the way.
Live viewer. H.264 through WebCodecs where the page can decode it, JPEG otherwise, negotiated per connection. Touch, drag, scroll, typing and paste, Home and Lock, light and dark, and a device picker. It reconnects by itself after a blip and says plainly when the simulator is off.
Agent cursor. Every agent gesture -- tap, long press, swipe, drag, typing -- reaches the viewer before it lands, and
the viewer's own pointer glides there first (agent.cursor_lead_ms). Never the Mac's pointer.
Screen understanding. A snapshot is a few lines -- e2 button "General" (201,319) -- with refs that stay with their
elements across scrolls, a digest, and diffs. sim_act plays up to 20 steps in one call and waits for text, its
absence, or the screen to settle -- past a spinner or a pulsing dot that never stops. An app turned to landscape is
read and touched in its own points, sim_device rotate turns a simulator, and a tap on what a tab bar, a toolbar or
the keyboard covers is refused with how to reach it. See Screen understanding.
Observe mode. For a walkthrough on an account the agent must not change, agent.observe refuses a tap on what
reads like Delete, Save, Send or Sign out -- in English and a dozen other languages, or styled destructive by its app --
unless the call confirms it. See Security.
Reading pixels. A screen whose accessibility says nothing -- a game, a canvas, an app still loading -- reads as the
text macOS's Vision finds in it, with refs to tap and text to wait for, and the viewer can outline what was read
(perception.ocr). See Read from pixels.
App SDK. An app under development can link SimMirrorKit, a small Swift package, and call SimMirror.start():
in a Debug build on the simulator it shares its own UIKit and SwiftUI views, so an icon-only button, a card with a tap
gesture or a hand-drawn control reads by name, and .simMirror("Settings") names a SwiftUI view. Optional, and nothing
of it is in a Release build. See The app SDK.
Real devices. A cabled iPhone or iPad shows up beside the simulators, and an agent can switch to it
(sim_device list and choose): its live screen over the cable, at about 55 frames a second; its apps, logs, look and
location through Xcode's devicectl; and touching, typing and its element tree through WebDriverAgent, set up once
with a click and signed by your project's own team -- a tap lands in about a third of a second. It is reached only over
the cable, and what SimMirror changes on it is put back when it is let go. See Real devices.
Recording. The viewer's Record button, sim_record or sim-mirror record keep a device's screen as an MP4, a GIF
or both, with each touch drawn where it landed and a 9:41 status bar, and preset: "pr" keeps one small enough for
a pull request. See Recording.
Connectors. SimMirror's own native helper gives full control with nothing to install; idb_companion still can,
and the simctl connector mirrors the screen view-only when neither is there, and says why. auto uses the fastest that
works and falls back when one fails. More connectors plug in through an entry point. See
Connectors.
Embedding. An iframe with a one-shot ticket, the
<sim-mirror> element themed with CSS custom properties, or SimMirror
inside a Python application with its own sign-in.
Settings panel. sim-mirror open --settings puts every setting a click away in the viewer, a tab per section,
saved for one project or all of them and applied before it says so. Settings that decide what runs or who may reach
the daemon wait for a code from sim-mirror settings confirm. See The settings panel.
Doctor. Checks Xcode, its Simulator frameworks, runtimes, the native helper and idb_companion, Device Hub and the desktop session, the text reader and an app's shared hierarchy, then proves a tap reaches a simulator. See the doctor.
Security. Loopback only, a Host allowlist, exact Origin checks, CORS and framing only for origins you list, hashed scoped tokens, and one-shot codes in URL fragments. See Security.
Build and test. sim_build_run and sim_test build with xcodebuild for the agent's simulator, install and
launch, and answer with only what failed and where -- each failing test named so it can be run again alone, and on
another simulator when asked -- and with the folder, branch and commit they built. They build the git worktree the
agent works in, with the configuration its scheme runs. Off by default, since they run commands: sim-mirror config set build.tools true.
benchmarks/tool_budget.py calls each read-only tool through the same MCP relay a client uses and prints each answer's
bytes, estimated tokens and latency on your own screens; see the token budget example. On
an iPhone 17 Pro simulator (iOS 26.5, idb connector) showing Settings → General, 5 calls each (2026-09-16):
Bytes are the whole answer, an image's base64 included; tokens are estimates (text at about 4 characters a token, an image at about 750 pixels a token).
Rows checked on real hardware are marked verified, with the date, in Compatibility.
From 1.0 the tools, the protocol, the embedding API, the viewer package, settings and the command line are held to what SimMirror promises not to break: a release adds, and never breaks; 2.0 broke nothing. Connectors are the exception, and pin a minor version.
Everything: getting started, clients, embedding, screen understanding, connectors, security, architecture, and the reference for tools, configuration, the command line and the protocol.
See ROADMAP.md and the milestones. How SimMirror relates to other tools is in Comparison.
Contributions are welcome. Read CONTRIBUTING.md and the Code of Conduct; AI coding agents read AGENTS.md. Report security issues privately as described in SECURITY.md. Questions go to Discussions.
Apache-2.0. See NOTICE and THIRD_PARTY_LICENSES.md.
SimMirror is an independent project, not affiliated with Apple or Anthropic. iOS, iPhone, Xcode and Simulator are trademarks of Apple Inc.; Claude and Claude Code are trademarks of Anthropic PBC.
Drive iOS Simulators, iPhones, Android devices and macOS apps: UI snapshots, live viewer, recording.
{ "mcpServers": { "io.github.andrewkochulab-sim-mirror": { "command": "uvx", "args": [ "sim-mirror==3.7.0" ] } }}도구
아직 도구 목록이 없습니다. 원격 서버는 첫 상태 확인 후에 도구 목록이 생깁니다.
FAQ
이 페이지에서 Cursor, Claude Desktop, Claude Code 또는 VS Code용 stdio 설정을 복사합니다. PlugMCP 프록시가 아니라 게시자의 설치 방식을 사용합니다.
이 레코드에는 필수 환경 변수가 등록되어 있지 않습니다.
SimMirror은(는) stdio를 통해 로컬에서 실행됩니다.
마지막 확인: 2026-11-16. Drive iOS Simulators, iPhones, Android devices and macOS apps: UI snapshots, live viewer, recording.