ios-debugger-agent

Build, run, launch, and debug iOS apps on a booted simulator using XcodeBuildMCP.

Updated Aug 5, 2025
One-click install
npx skills add https://github.com/DishaAnand/FocusNest --skill ios-debugger-agent-dishaanand
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ios-debugger-agent
Source: https://github.com/DishaAnand/FocusNest/tree/main/.agents/skills/ios-debugger-agent
Command: npx skills add https://github.com/DishaAnand/FocusNest --skill ios-debugger-agent-dishaanand

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers build, run, and debug iOS projects on a booted simulator using XcodeBuildMCP, enabling automated workflows for testing and diagnosing runtime behavior.

Core Features & Use Cases

  • Build and run the current iOS project scheme on a booted simulator.
  • Launch the app, inspect on-screen UI state, and capture logs for debugging.
  • Use MCP tooling to interact with the running app (describe UI, tap, type, and observe state) and diagnose runtime issues.

Quick Start

  1. Ensure Xcode and MCP tools are installed and a supported iOS simulator is booted.
  2. Use the ios-debugger-agent to discover the booted simulator and set session defaults (projectPath or workspacePath, scheme, simulatorId).
  3. Build, run, or launch the app, capture logs, and inspect UI state as needed.

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 running an iOS app on a simulator?

You can automate building and running an iOS app on a booted simulator by using XcodeBuildMCP tooling to discover the simulator, configure session defaults, build the project scheme, and launch the app for automated testing.

What is the best way to capture runtime logs from an iOS simulator?

Capturing runtime logs from an iOS simulator involves launching the app on a booted simulator via XcodeBuildMCP and using the tooling to capture logs, inspect UI state, and diagnose runtime behavior during development or QA workflows.

Can I interact with the UI of an iOS app running on a booted simulator?

Yes, you can interact with the UI of an iOS app on a booted simulator by using MCP tooling to describe the on-screen UI state, tap elements, type text, and observe state changes to diagnose runtime issues.

Do I need XcodeBuildMCP to debug iOS apps on a booted simulator?

Yes, XcodeBuildMCP is required to debug iOS apps on a booted simulator, as it provides the tooling to discover booted simulators, configure sessions, build or launch apps, and capture logs for diagnosing runtime behavior.

How do I configure a debugging session for an iOS simulator?

To configure a debugging session for an iOS simulator, discover the booted simulator and set session defaults including the projectPath or workspacePath, the project scheme, and the simulatorId using XcodeBuildMCP tooling.

Why are my iOS simulator logs not showing up during automated debugging?

Simulator logs may not show up if the simulator is not properly booted or session defaults are misconfigured; ensure a supported iOS simulator is booted and XcodeBuildMCP correctly captures logs after launching the app.