skills.rest
AarnavBaddam
AarnavBaddamCOMMUNITY
Explore all skills by this author →
GitHub

ios-debugger-agent

Build, launch, and debug iOS apps on booted simulators using XcodeBuildMCP.

Updated Jul 31, 2026
Search Tags:#debugging#build#ios#simulator#xcodebuildmcp#ui inspection#log capture
One-click install
npx skills add https://github.com/AarnavBaddam/skills --skill ios-debugger-agent-aarnavbaddam
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ios-debugger-agent
Source: https://github.com/AarnavBaddam/skills/tree/main/ios-debugger-agent
Command: npx skills add https://github.com/AarnavBaddam/skills --skill ios-debugger-agent-aarnavbaddam

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Debugging iOS apps on a simulator requires juggling build commands, simulator state, UI inspection, and log capture across many tools. This Skill orchestrates the entire cycle through XcodeBuildMCP so you can build, run, interact with, and diagnose your app from a single workflow. ## Core Features & Use Cases - Build and Run Automation: Discovers the booted simulator, sets session defaults (project, scheme, simulator ID), and builds and launches the app with build-failure recovery guidance. - UI Interaction and Inspection: Describes the view hierarchy, taps elements, types text, performs gestures, and captures screenshots to verify runtime behavior. - Log Capture and Diagnosis: Starts and stops simulator log capture filtered by bundle ID, with console output support for diagnosing runtime issues. - Use Case: You just changed a view controller and want to verify it works. Ask the agent to build and run the app on the booted simulator, tap through the new screen, and capture logs to confirm no errors occur. ## Quick Start Use the ios-debugger-agent to build and run my current scheme on the booted simulator, then describe the UI and capture the app logs.

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 run an iOS app on a simulator with XcodeBuildMCP?▼

Set session defaults with your project path, scheme, and booted simulator ID, then call build_run_sim. After a successful build, verify the launch with describe_ui or screenshot before interacting with the app.

How do I inspect and tap UI elements in an iOS simulator?▼

Call describe_ui first to get the current view hierarchy, then use tap with an element id or label, falling back to coordinates only if needed. Use type_text for text fields and gesture for scrolls and edge swipes.

What should I do when no iOS simulator is booted?▼

Run list_sims to check simulator states. If none show Booted, ask the user to boot one manually, since the workflow does not boot simulators automatically unless explicitly requested.

Why does my iOS simulator build fail and how do I fix it?▼

Check the build error output first, then retry with preferXcodebuild set to true, which uses xcodebuild directly. If the failure persists, escalate to the user before attempting any UI interaction.

How do I capture logs from a running iOS simulator app?▼

Call start_sim_log_cap with the app's bundle ID to begin capture, then stop_sim_log_cap to end it and summarize important lines. Set captureConsole to true and relaunch if you need console output.

How do I find the bundle ID of an app installed on a simulator?▼

Call get_sim_app_path to locate the installed app on the simulator, then call get_app_bundle_id with that path. This is needed before launching the app or starting log capture.

Related Skills

Explore More Software Engineering Skills→
wisdom-in-a-nutshellwisdom-in-a-nutshell
25

ios-debugger-agent

Build, launch, and debug iOS apps on booted simulators using XcodeBuildMCP.

Official
Intermediate
Alex1980AlexAlex1980Alex

fix-sonar-task

Orchestrate SonarQube issue remediation for 1C projects through analysis, implementation, testing, and rescanning.

Community
Advanced
thurnthurn
1

adversarial-test-validation

Injects temporary user-visible bugs to verify test suites catch real regressions.

Community
Advanced
femitzfemitz

debugging-instruments

Guide LLDB, Memory Graph Debugger, and Instruments to diagnose iOS app crashes and leaks.

Community
Advanced