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.