ios-debugger-agent

Build, launch, and inspect iOS apps on a booted simulator.

Updated Feb 11, 2026

Search Tags:#automation #debugging #ios #simulator #xcodebuildmcp #ui-inspection

Ready to run

npx skills add https://github.com/mschuerig/peach-ios --skill ios-debugger-agent-mschuerig

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: ios-debugger-agent
Source: https://github.com/mschuerig/peach-ios/tree/main/.agents/skills/ios-debugger-agent
Command: npx skills add https://github.com/mschuerig/peach-ios --skill ios-debugger-agent-mschuerig

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The iOS Debugger Agent orchestrates building, launching, and debugging the current iOS project on a booted simulator using XcodeBuildMCP tools to control the simulator, run the app, and capture logs for diagnostics.

Core Features & Use Cases

Discover the booted simulator and set session defaults
Build, run, and launch the current app on the booted simulator
Inspect the UI state, perform taps/types, and capture screenshots for troubleshooting
Collect logs and console output for post-mortem analysis and runtime diagnosis

Quick Start

Boot a simulator and run ios-debugger-agent to build, launch, and inspect the current iOS app

Frequently Asked Questions about ios-debugger-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I build and debug an iOS app on a booted simulator?▼

To debug an iOS app on a booted simulator, you need to build the project scheme, launch the app, inspect the UI state, perform interactions, and capture runtime logs for diagnostics.

Can I capture screenshots and logs for iOS simulator UI inspection?▼

Yes, iOS simulator UI inspection allows you to capture screenshots and collect console logs. This enables you to perform taps and types on the interface for post-mortem runtime diagnosis.

How do I automate UI interaction testing for an iOS project scheme?▼

Automating UI interaction testing for an iOS project scheme involves launching the app on a booted simulator, describing the UI state, and programmatically performing taps and types to verify interface behavior.

Do I need XcodeBuildMCP to run an iOS app on a booted simulator?▼

Using XcodeBuildMCP tools is required to control the booted simulator, build the project scheme, run the app, and collect logs for reliable simulator-based testing and diagnosis.

What is the best way to diagnose runtime failures in an iOS simulator?▼

The best way to diagnose iOS simulator failures is to capture console output and logs during the app session. This log-based diagnosis helps identify issues after performing build, run, and UI interactions.

Why does my iOS app debugging session fail to launch on a booted simulator?▼

Debugging session failures often occur when a simulator is not properly booted or project scheme defaults are misconfigured. You must identify the booted simulator and set session defaults before building.