ios-debugger-agent

Build, run, and debug iOS apps on booted simulators via XcodeBuildMCP.

3.9k|203|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/Dimillian/Skills --skill ios-debugger-agent-dimillian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ios-debugger-agent
Source: https://github.com/Dimillian/Skills/tree/main/ios-debugger-agent
Command: npx skills add https://github.com/Dimillian/Skills --skill ios-debugger-agent-dimillian

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates building, running, and debugging the current iOS project on a booted simulator using MCP tools, reducing manual setup and speeding iteration.

Core Features & Use Cases

  • Discover booted simulators and initialize a session with project/workspace and scheme
  • Build, run, or launch the app on a booted simulator and capture logs
  • Interact with the running UI (tap, type, gestures) and inspect on-screen state for debugging

Quick Start

Boot a simulator, configure the session with your project and scheme, then build and run the app using mcp__XcodeBuildMCP__build_run_sim (or launch if already built).

Frequently Asked Questions about ios-debugger-agent

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

FAQPage Schema
How do I debug an iOS app on a simulator using automation?

You can debug an iOS app on a simulator by automating the build, run, and launch processes via XcodeBuildMCP commands to quickly test and inspect runtime behavior without manual setup.

Can I interact with the UI of a running iOS app on a booted simulator?

Yes, you can interact with the running UI on a booted simulator by applying taps, typing, and gestures, then inspecting the on-screen state to diagnose runtime behavior.

How do I capture logs from an iOS simulator during a debug session?

To capture logs during an iOS simulator debug session, you build and run or launch the app using MCP commands, which automatically captures runtime logs for diagnostic workflows.

Do I need a booted simulator to run and test my iOS project?

Yes, this workflow requires a booted simulator because the process discovers available simulators, sets session defaults for your project and scheme, and then builds and runs the app directly on it.

What's the best way to speed up iOS app testing and iteration on simulators?

The best way to speed up iOS app testing iteration is to automate session initialization, building, running, and UI interaction on booted simulators using MCP tools, reducing manual configuration.

How do I initialize a debug session for an iOS workspace?

You initialize a debug session by discovering booted simulators and configuring the session defaults with your specific project or workspace file and scheme before building and running the app.