🦀 ClawHub
Mirroir
by @jfarcand
Control a real iPhone through macOS iPhone Mirroring — screenshot, tap, swipe, type, launch apps, record video, OCR, and run multi-step scenarios. Works with...
⚡ When to Use
💡 Examples
Send an iMessage on iPhone
1. launch_app "Messages"
2. describe_screen → find "New Message" button coordinates
3. tap [x] [y] on "New Message"
4. type_text "Alice"
5. describe_screen → find Alice in suggestions
6. tap [x] [y] on Alice
7. tap [x] [y] on the message field
8. type_text "Running 10 min late"
9. press_key return
10. screenshot → confirm sent
Test a login flow
1. launch_app "MyApp"
2. describe_screen → find Email field
3. tap [x] [y] on Email
4. type_text "${TEST_EMAIL}"
5. tap [x] [y] on Password
6. type_text "${TEST_PASSWORD}"
7. tap [x] [y] on "Sign In"
8. describe_screen → verify "Welcome" appears
Running late — check Waze ETA and notify the team on Slack
1. launch_app "Waze"
2. describe_screen → read ETA to current destination (e.g. "23 min")
3. press_home
4. launch_app "Slack"
5. describe_screen → find target channel
6. tap [x] [y] on "#standup"
7. tap [x] [y] on message field
8. type_text "Heads up — Waze says 23 min out, be there by 9:25"
9. press_key return
10. screenshot → confirm sent
Record a bug reproduction
1. start_recording
2. launch_app "Settings"
3. scroll_to "General"
4. tap [x] [y] on "General"
5. scroll_to "About"
6. tap [x] [y] on "About"
7. stop_recording → returns path to .mov file
⚙️ Configuration
After installing, run the setup to configure the helper daemon and Karabiner:
# One-line install (recommended)
/bin/bash -c "$(curl -fsSL https://mirroir.dev/get-mirroir.sh)"Or via Homebrew
brew tap jfarcand/tap && brew install iphone-mirroir-mcpOr via npx
npx -y iphone-mirroir-mcp install
Approve the Karabiner DriverKit extension if prompted: System Settings > General > Login Items & Extensions — enable all toggles under Karabiner-Elements.
📋 Tips & Best Practices
describe_screen before tapping — never guess coordinates.scroll_to "label" to find off-screen elements instead of manual swiping.reset_app before launch_app to ensure a fresh app state.press_key with modifiers (e.g., press_key n [command] for new message in Mail).describe_screen with skip_ocr: true returns only the grid screenshot, letting your vision model identify icons and images OCR can't read.TERMINAL
clawhub install mirroir