Real runs on a real iPhone
Three ways to use it
Your personal agent
Errands across the apps already signed in on your phone. It reads the screen and listens: a saved recipe reel becomes a grocery list. No connector, no password handed to anyone.
Games
It plays turn-based and tap-driven games, frame by frame, under a budget. With Stockfish choosing the moves, it beat Chess.com's strongest bot.
Automation
A flow that worked becomes a skill that replays without an LLM. mirroir-run runs it in CI with the web and your API, and flags drift.
A skill is a short Markdown file
---
name: Set Timer
app: Clock
---
## Steps
1. Launch **Clock**
2. Tap "Timer"
3. Tap "Start"
4. Verify "Pause" is visibleSteps match text on screen, not coordinates. Once compiled, mirroir test replays it without an LLM. The full skill · More skills
Install v0.49.0
Paste this into your coding agent:
Set up mirroir-mcp so you can drive my iPhone: follow https://github.com/jfarcand/mirroir-mcp/blob/main/docs/onboarding.md step by step, and finish by reading back what my iPhone screen shows.Or install it yourself:
$ brew tap jfarcand/tap && brew install mirroir-mcp$ npx -y mirroir-mcp install$ /bin/bash -c "$(curl -fsSL https://mirroir.dev/get-mirroir.sh)"Claude Desktop: download the extension and double-click it.
Claude Code plugin, Hermes Agent: every install option.
Safety
- Read-only by default. Tools that change anything stay hidden until you allow them.
- Block apps. Keep the agent out of Wallet or your bank.
- Stop anytime. Quit iPhone Mirroring or lock the Mac.
FAQ
Does it work with any iPhone app?
Yes. If iPhone Mirroring shows it, your agent can use it.
Will it take over my Mac?
No. Taps and typing reach the phone while you keep working; a swipe moves the pointer for a moment.
Does my phone's audio leave my Mac?
No. macOS transcribes it on the Mac. Screenshots go to the model that runs your agent.
Which agents work with it?
Any MCP client: Claude Code, Codex, Cursor, Claude Desktop, Hermes and more.