ios-debugger-agent

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

Updated Feb 11, 2026
One-click install
npx skills add https://github.com/mschuerig/peach-ios --skill ios-debugger-agent-mschuerig
Or copy as Structured Prompt for Agent▼
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.