ios-safari-debug

iOS Safari Debugging

Use this skill to inspect and debug Safari tabs on a connected iOS device through ios-webkit-debug-proxy (iwdp).

Prerequisites

1. Check iwdp status — call iwdp_status first. It checks if ios-webkit-debug-proxy is running and auto-starts it if needed (no manual shell commands required).

2. An iOS device must be connected via USB with Safari open and Web Inspector enabled (Settings > Safari > Advanced > Web Inspector).

Port Layout

• Port 9221 — listing port: returns all connected devices
• Port 9222 — first device's pages
• Port 9223 — second device's pages (and so on)

Each device entry from port 9221 includes a URL field (e.g., localhost:9222) indicating which port to query for that device's pages.

Workflow

1. Ensure iwdp is running — call iwdp_status to verify (it auto-starts if needed).

2. List devices — use list_devices to see connected iOS devices and their port assignments.

3. List pages — use list_pages (optionally with port for a specific device) to discover open Safari tabs. Each entry includes a title, URL, and webSocketDebuggerUrl.

4. Select a page — use select_page with the WebSocket URL from the listing to connect to the target tab.

5. Use debugging tools for the task at hand. Available tools include:

   • navigate — go to a URL
   • evaluate_script — run JavaScript in the page
   • take_screenshot — capture the page as a PNG file (returns path — use Read to view)
   • get_document / query_selector / get_outer_html — inspect the DOM
   • click / fill / type_text — interact with page elements
   • get_cookies / set_cookie / delete_cookie — manage cookies (incl. httpOnly)
   • get_local_storage / get_session_storage — read web storage
   • get_computed_style / get_matched_styles — inspect CSS
   • network_enable / list_network_requests — monitor network traffic
   • get_console_messages — collect console output
   • Debugger, Timeline, Memory, Profiler, and more