---

name: iphone-screen-capture description: Start the iPhone screen capture app to mirror a connected iPhone's screen on macOS. Use when the user wants to view their iPhone screen, mirror their device, or start screen capture.

iPhone Screen Capture

Overview

Native macOS app that mirrors a connected iPhone's screen on the Mac desktop using AVFoundation. Features an integrated console for live app logs via pymobiledevice3.

When to Use

Invoke this skill when the user:

• Asks to "start screen capture"
• Wants to "see their iPhone screen"
• Wants to "mirror their iPhone"
• Mentions viewing or displaying their connected device
• Says "show me my phone"

Prerequisites

• iPhone connected via USB
• Device trusted (tap "Trust This Computer" on iPhone)
• pymobiledevice3 installed for console logs (pip3 install pymobiledevice3)

Instructions

1. Navigate to the screen capture directory:

   cd miso/platforms/ios/development/screen-capture/imp
   

2. Run the screen capture script:

   ./iphone_screencap.sh
   

Features

• Borderless window (390x844) styled like an iPhone
• Console toggle: Click ">" button in top-right to open live log panel
• Click to resize: Click window to toggle between full and half size
• Draggable: Move window by clicking and dragging anywhere
• Live logs: Console shows [APP] prefixed logs via pymobiledevice3 syslog

What to Tell the User

• A borderless window will appear showing their iPhone screen
• Click the ">" button to open the console panel with live logs
• Click anywhere on the window to toggle full/half size
• Close window or Cmd+Q to quit

Taking Screenshots

./screenshot.sh /tmp/screenshot.png

Reading Logs (for Claude)

When console is open, logs stream via pymobiledevice3. Claude can also read logs with:

pymobiledevice3 syslog live 2>/dev/null | grep "\[APP\]" | head -20

Troubleshooting

iPhone screen not showing:

• Check USB connection
• Ensure iPhone is unlocked
• Accept "Trust This Computer" prompt
• Disconnect and reconnect device

Console not working:

• Install pymobiledevice3: pip3 install pymobiledevice3
• Check device is trusted

Files

• main.swift - Native macOS app source
• build.sh - Compiles the Swift app
• iphone_screencap.sh - Builds (if needed) and launches
• screenshot.sh - Captures device screenshot