ios-debugger-agent

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

3.9k|203|Updated Dec 30, 2025

Search Tags:#automation #debugging #logs #ios #simulator #XcodeBuildMCP #ui-interaction

Ready to run

npx skills add https://github.com/Dimillian/Skills --skill ios-debugger-agent-dimillian

💬 Prompt for ChatGPT / Claude Chat▼

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.