ios-debugger-agent

Automate building, launching, and debugging iOS apps on a booted simulator with XcodeBuildMCP.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/jperezdelreal/GymBro --skill ios-debugger-agent-jperezdelreal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ios-debugger-agent
Source: https://github.com/jperezdelreal/GymBro/tree/main/.squad/skills/ios/ios-debugger-agent
Command: npx skills add https://github.com/jperezdelreal/GymBro --skill ios-debugger-agent-jperezdelreal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps developers automate building, launching, and debugging iOS apps on a booted simulator using XcodeBuildMCP.

Core Features & Use Cases

  • Discover a booted iOS simulator and manage sessions with MCP tool calls.
  • Build and run the app scheme on the selected simulator, with verification of launch.
  • Interact with the running UI through taps, types, and gestures, and capture logs or screenshots for debugging.
  • Troubleshoot builds and UI issues with guided workflows and error checks.

Quick Start

Boot a simulator, then use XcodeBuildMCP to build and run the current project scheme on it.

Frequently Asked Questions about ios-debugger-agent

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

FAQPage Schema
How do I automate iOS simulator debugging and UI testing using MCP commands?

You can automate iOS simulator debugging by using XcodeBuildMCP commands to discover a booted simulator, set up a session, build the project scheme, launch the app, interact with the UI, and capture logs.

What is needed to start building and running an iOS app on a simulator with MCP tools?

To start building and running an iOS app with MCP tools, you need a currently booted iOS simulator, the current Xcode project scheme, and XcodeBuildMCP commands to manage the build and launch verification process.

Can I capture logs and screenshots while interacting with the iOS simulator UI?

Yes, you can interact with the running UI through taps, types, and gestures while simultaneously capturing logs and screenshots to troubleshoot builds and UI issues during iOS simulator debugging sessions.

Does iOS debugging with XcodeBuildMCP support troubleshooting failed app launches?

Yes, the debugging workflow includes guided troubleshooting with error checks to verify app launch success and diagnose build or UI issues on the booted iOS simulator using MCP tool calls.

Why is my iOS simulator not being discovered during the MCP build and run process?

Simulator discovery fails if there is no currently booted iOS simulator. You must boot a simulator in Xcode before initiating the MCP commands for session setup, project scheme building, and app launch.