ios-debugger-agent

Automate iOS app build, launch, and debugging on a booted simulator.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/PicoMLX/SwiftSQLite --skill ios-debugger-agent-picomlx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ios-debugger-agent
Source: https://github.com/PicoMLX/SwiftSQLite/tree/main/.agents/skills/ios-debugger-agent
Command: npx skills add https://github.com/PicoMLX/SwiftSQLite --skill ios-debugger-agent-picomlx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill eliminates the manual overhead of managing iOS simulator states, building projects, and capturing runtime logs, allowing developers to focus on debugging and UI verification.

Core Features & Use Cases

  • Simulator Orchestration: Automatically discover booted simulators and manage app lifecycles.
  • UI Inspection & Interaction: Describe UI elements, perform taps, gestures, and capture screenshots for visual validation.
  • Log Management: Stream and summarize console output to diagnose runtime behavior and crashes.
  • Use Case: When a UI bug is reported, use this skill to launch the app, inspect the view hierarchy, and capture the console logs during the failure to pinpoint the root cause.

Quick Start

Use the ios-debugger-agent to build the current project and launch it on the booted simulator to inspect the UI.

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

You can automate iOS app debugging by using this skill to build the project, launch the app on a booted simulator, inspect the UI, and capture console logs in real time to diagnose runtime behavior.

Can I capture runtime iOS simulator logs to diagnose a UI bug?

Yes, you can stream and summarize console output during app execution to pinpoint the root cause of a UI bug. This skill captures real-time simulator logs while you interact with the application.

Do I need an active Xcode project to inspect the iOS simulator UI?

Yes, you need a configured Xcode project and an active simulator environment to execute build and runtime commands. This skill relies on XcodeBuildMCP tools to orchestrate the build and launch lifecycle.

How do I perform gesture interactions and capture screenshots on an iOS simulator?

You can perform taps and gestures on the simulator by orchestrating app lifecycles and inspecting UI elements. This skill facilitates gesture interaction and captures screenshots for visual validation of your mobile app.

What is the best way to inspect the view hierarchy of an iOS app during a crash?

The best way to inspect a view hierarchy during a crash is to launch the app on a booted simulator, interact with the UI, and stream the console logs. This captures the failure state for diagnostic purposes.