skills.rest
harperreed
harperreedCOMMUNITY
Explore all skills by this author →
Website𝕏@harperGitHub

ios-debugger-agent

Build, run, and debug iOS projects on a booted simulator with UI inspection and log capture.

330|47|Updated Aug 30, 2020
Search Tags:#ios#ui automation#xcodebuild#mcp tools#runtime diagnostics#log capture#simulator debugging
One-click install
npx skills add https://github.com/harperreed/dotfiles --skill ios-debugger-agent-harperreed
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ios-debugger-agent
Source: https://github.com/harperreed/dotfiles/tree/main/.claude/skills/ios-debugger-agent
Command: npx skills add https://github.com/harperreed/dotfiles --skill ios-debugger-agent-harperreed

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you quickly build, run, and debug the current iOS project while inspecting the simulator UI and capturing runtime logs, so you can diagnose why an app behaves unexpectedly.

Core Features & Use Cases

  • Simulator discovery & session setup: Finds a booted iOS simulator and configures the active Xcode scheme and session defaults.
  • Build/run/launch control: Builds and runs the scheme, or relaunches the app when only launch is requested, including bundle ID detection when needed.
  • UI inspection and interaction: Describes UI elements, taps, types, performs gestures, and captures screenshots to verify on-screen state.
  • Logs & console capture: Starts and stops simulator log capture and summarizes important output lines for troubleshooting.

Quick Start

Ask the agent to run the current iOS app on the booted simulator and capture logs for the moment the issue happens.

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 booted simulator while inspecting UI state?▼

To debug an iOS app on a simulator, you can build and run the active Xcode scheme on a booted simulator, inspect UI elements, and capture runtime logs to diagnose unexpected behavior visually and programmatically.

Can I capture runtime logs from an iOS simulator to troubleshoot app issues?▼

Yes, you can capture runtime logs from an iOS simulator by starting and stopping log capture using the app bundle ID, which summarizes important console output lines for troubleshooting app behavior.

How do I automate UI interactions like taps and gestures on an iOS simulator?▼

You can automate UI interactions on an iOS simulator by describing UI elements, performing taps, typing text, executing gestures, and capturing screenshots to verify the on-screen state of your application.

Do I need XcodeBuildMCP to run and debug an iOS app on a simulator?▼

Yes, XcodeBuildMCP is required to list available simulators and configure session defaults, enabling the build, run, and launch flow for your active Xcode scheme on the booted simulator.

What is the best way to relaunch an iOS app on a simulator without rebuilding?▼

To relaunch an iOS app without rebuilding, you can request a launch-only flow which detects the app bundle ID and starts the application on the booted simulator for continued debugging.

Why is my iOS simulator debugging session not capturing console output?▼

Simulator console output capture requires starting log capture specifically using the app bundle ID, ensuring the active Xcode scheme is properly configured and the simulator is fully booted before running.

Related Skills

Explore More Software Engineering Skills→
robinebersrobinebers
46

ios-debugger-agent

Build and debug iOS applications on simulators using XcodeBuildMCP.

Community
Advanced
tw93tw93
6.8k

hunt

Diagnose root causes of bugs using hypothesis-driven evidence validation.

Community
Advanced
curtislmartincurtislmartin

ios-debugger-agent

Build, run, and debug iOS projects on a booted simulator.

Community
Intermediate
iPlug2iPlug2
152

run-ios-simulator

Build and launch iPlug2 iOS apps in the iOS Simulator with xcodebuild and xcrun simctl.

Official
Advanced