skills.rest
wisdom-in-a-nutshell
wisdom-in-a-nutshellOFFICIAL
Explore all skills by this author →
WebsiteGitHub

ios-debugger-agent

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

25|1|Updated Feb 10, 2026
Search Tags:#debugging#logs#build#ios#xcode#simulator#ui inspection
One-click install
npx skills add https://github.com/wisdom-in-a-nutshell/agents --skill ios-debugger-agent-wisdom-in-a-nutshell
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ios-debugger-agent
Source: https://github.com/wisdom-in-a-nutshell/agents/tree/main/plugins-source/external/build-ios-apps/skills/ios-debugger-agent
Command: npx skills add https://github.com/wisdom-in-a-nutshell/agents --skill ios-debugger-agent-wisdom-in-a-nutshell

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Debugging iOS apps on a simulator requires juggling Xcode builds, simulator state, UI inspection, and log capture across many manual steps. This Skill orchestrates that entire loop through XcodeBuildMCP so you can build, run, interact with, and inspect your app from a single conversation. ## 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 and summarizes important console output. - Use Case: You just changed a view controller and want to verify it renders correctly. The Skill builds the scheme on the booted simulator, launches the app, describes the UI, taps through the flow, and pulls the relevant logs. ## Quick Start Use the ios-debugger-agent skill to build and launch 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 from the command line?▼

Use XcodeBuildMCP's build_run_sim tool after setting session defaults with your project path, scheme, and booted simulator ID. The Skill discovers the booted simulator first and verifies the app launched via describe_ui or screenshot.

How do I inspect the UI of a running iOS simulator app?▼

Call the describe_ui tool to get the current view hierarchy before interacting. You can then tap elements by id or label, type text into focused fields, perform gestures, and capture screenshots for visual confirmation.

How do I capture logs from an iOS simulator app?▼

Start log capture with start_sim_log_cap using the app's bundle ID, then stop it with stop_sim_log_cap to retrieve and summarize the output. Set captureConsole to true and relaunch if you need console output.

What if no iOS simulator is booted?▼

The Skill lists simulators with list_sims and selects one in the Booted state. If none are booted, it asks you to boot one manually rather than booting automatically without permission.

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

Build failures are surfaced in the build_run_sim error output. The Skill can retry with preferXcodebuild set to true, or escalate to you before attempting any UI interaction with a stale build.

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

Use get_sim_app_path to locate the installed app, then call get_app_bundle_id to resolve its bundle identifier. This is needed before launching the app directly or starting log capture.

Related Skills

Explore More Software Engineering Skills→
openaiopenai
5.3k

ios-debugger-agent

Build, run, and debug iOS apps on Simulator using XcodeBuildMCP tools.

Official
Intermediate
SavigeSystemZSavigeSystemZ

etherweave-debug-playbook

Diagnose and guide fixes for EtherWeave build, runtime, and UI failures.

Official
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