- name
SKILL.md
The skill file stays in the publisher's repository.
Paste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add jfarcand/mirroir-mcp --skill mirroir -a cursor -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add jfarcand/mirroir-mcp --skill mirroir -a claude-code -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add jfarcand/mirroir-mcp --skill mirroir -a codex -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add jfarcand/mirroir-mcp --skill mirroir -a grok -ySend the copied message in a Grok Bot chat. The Bot fetches this SKILL.md from GitHub and adds it to the skills all your Bots share.
Install this skill: https://github.com/jfarcand/mirroir-mcp/tree/HEAD/plugins/hermes/skills/mirroirFrom the publisher
mirroir drives the user's own iPhone through macOS iPhone Mirroring: you see the screen as text with tap points, and you tap, type and swipe on the real device. The phone is the user's, with their accounts and data on it, so every action is real.
Skip this when the mirroir tools are already available. mirroir needs macOS 15 or later with iPhone Mirroring connected to the iPhone. Register the server with your host:
claude mcp add --transport stdio mirroir -- npx -y mirroir-mcpcodex mcp add mirroir -- npx -y mirroir-mcpopenclaw mcp add mirroir --command mirroir-mcpThen run mirroir-mcp doctor: every line that does not pass names its fix. Screen Recording and Accessibility are granted by the user, to the app that runs the server; tell them which pane and which app, and never change a permission yourself. The full guide is https://github.com/jfarcand/mirroir-mcp/blob/main/docs/onboarding.md.
mirroir drives the user's real iPhone through macOS iPhone Mirroring. Work in small, checked steps:
mirroir-mcp skill for the full manual.The harness reports what it saw and did; you decide what it means. A tool that succeeds only says the input was delivered: the screen after it says whether it worked.
describe_screen returns every text element with its tap point, in the same points tap takes. Use omit_screenshot: true unless you need to see an image.query lists only elements containing a text (for example ° for temperatures), and text_only: true drops coordinates when you only read.settle_ms: 0.scroll_to with its label scrolls until it shows. Its direction is where that text is (down by default, for what is below), not the way the finger moves.screenshot is for what text cannot tell: images, colors, layout. Its reply states the image's pixel size. To tap something only the image shows, give tap its position in the image as x and y with image_size.listen, passing the iPhone's language as language (for example fr-CA). It returns the words heard; silence means nothing played.tap(text:) finds text that describe_screen listed and taps it; a miss lists the text that is on screen. tap(x:, y:) takes a point from describe_screen.launch_app(name:) opens an app through Spotlight. open_url opens a link in Safari.press_back taps the back chevron; press_home goes to the Home Screen; press_app_switcher shows open apps; reset_app force-quits one.swipe from bottom to top shows what is below. To page a video feed, flick: about 75% of the screen height with duration_ms 150. A long duration_ms scrolls slowly without inertia.long_press opens context menus; double_tap zooms or selects; drag moves icons and sliders.run_steps runs a list of steps you have already seen work, such as ["tap: @324,113", "type: calculator", "press_key: return"]. A control with no readable text is named by its point: "tap: @324,113". Text must be what the screen shows, in the iPhone's language. Every step is checked against the permissions before any runs, and the run stops at the first failure. The reply ends with the text on screen.type_text.press_key sends return, escape, tab, delete and arrows. Only shortcuts iOS itself implements work: Cmd+A, Cmd+C and Cmd+V in text fields, Cmd+L in Safari.Taps, typing and swipes go to the iPhone Mirroring window without bringing it to the front, so the user can keep working. Drags and two-finger gestures bring it forward for their duration and then return the front and the pointer. If another window covers the mirror, those gestures are refused rather than sent to the wrong app.
iPhone Mirroring stops when the iPhone is unlocked and in use, when the Mac locks, or when the connection times out. The error quotes the window's own text and names what the user must do (usually: lock the iPhone, or approve on the Mac). Relay it, wait for the user, then retry once. Never loop, and never press a sheet that asks for a password or Touch ID: that approval belongs to the user.
list_skills and get_skill read saved skills: Markdown step lists for a task.record_step after each step and save_compiled at the end record a compiled replay; mirroir test then runs it without a model.status and check_health diagnose the connection when tools start failing.get_notes reads what an agent learned about an app in earlier sessions; save_note keeps one more line for the next one, under the app's name as topic. Pass replaces with a note's text to correct it.Drive a real iPhone through macOS iPhone Mirroring with the mirroir MCP tools: read the screen, tap, type, swipe, open apps, and replay skills. Use whenever a task needs the user's phone.
---name: mirroirdescription: Drive a real iPhone through macOS iPhone Mirroring with the mirroir MCP tools: read the screen, tap, type…---# plugins/hermes/skills/mirroir/SKILL.mdFAQ
Download plugins/hermes/skills/mirroir/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
The publisher keeps it at https://github.com/jfarcand/mirroir-mcp.
Claude, Cursor, Codex, and Grok Build can read a SKILL.md you add from the publisher's repository. Grok Bot installs it when you send the skill's GitHub folder link in a chat.