ios-debugger-agent

Build, launch, and debug iOS projects on a booted simulator via XcodeBuildMCP.

Updated Feb 22, 2026
One-click install
npx skills add https://github.com/pyronaur/ngents --skill ios-debugger-agent-pyronaur
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ios-debugger-agent
Source: https://github.com/pyronaur/ngents/tree/main/docs/topics/apple/skills/ios-debugger-agent
Command: npx skills add https://github.com/pyronaur/ngents --skill ios-debugger-agent-pyronaur

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates building, launching, and debugging an iOS project on a booted simulator using XcodeBuildMCP, enabling rapid iterative testing and issue diagnosis.

Core Features & Use Cases

  • Build and run the current project scheme on a booted iOS simulator.
  • Interact with the simulator UI: describe UI, tap, type, and gesture.
  • Inspect on-screen state and capture logs/console output for debugging.
  • Diagnose runtime behavior using XcodeBuildMCP tooling and session defaults.
  • Manage session defaults for projectPath/workspacePath, scheme, and simulatorId; optional: configuration, useLatestOS.
  • Launch app if already built; resolve bundle id when unknown.

Quick Start

Boot an iOS simulator and instruct the agent to build, run, launch, and debug the current project with XcodeBuildMCP.

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 building and launching an iOS app on a simulator?

You can automate building and launching an iOS app on a booted simulator by configuring session defaults for projectPath, scheme, and simulatorId, then instructing the agent to run the build and launch sequence.

Can I interact with the iOS simulator UI during automated debugging?

Yes, you can interact with the simulator UI during automated debugging by instructing the agent to describe UI elements, tap, type text, and perform gestures to test runtime behavior.

How do I capture console logs and diagnose runtime issues on an iOS simulator?

You can capture console logs and diagnose runtime issues by launching the app on the booted simulator and using the agent to inspect on-screen state and capture log output for diagnostics.

Do I need to provide a bundle ID to launch an already built iOS app on the simulator?

No, you do not need to provide a bundle ID to launch an already built app; the agent can automatically resolve the bundle ID when it is unknown.

What settings are required to start an iOS simulator debugging session?

Starting an iOS simulator debugging session requires configuring session defaults for projectPath or workspacePath, scheme, and simulatorId, with optional configuration and useLatestOS settings.

Why is my iOS simulator debugging automation not working?

iOS simulator debugging automation may not work if the simulator is not booted or if required session defaults like projectPath, scheme, and simulatorId are not properly configured.