ios-debugger-agent

Build, launch, and drive iOS Simulator apps using XcodeBuildMCP tools.

6|6|Updated Aug 7, 2026
One-click install
npx skills add https://github.com/NateBJones-Projects/unlock-ai-workbench --skill ios-debugger-agent-natebjones-projects
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ios-debugger-agent
Source: https://github.com/NateBJones-Projects/unlock-ai-workbench/tree/main/.agents/skills/ios-debugger-agent
Command: npx skills add https://github.com/NateBJones-Projects/unlock-ai-workbench --skill ios-debugger-agent-natebjones-projects

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires xcodebuildmcp.

What problem does it solve? Verifying iOS app changes normally requires juggling raw xcodebuild, xcrun, and simctl commands, guessing simulator states, and tapping blind coordinates. This Skill standardizes the whole loop through the repository-configured XcodeBuildMCP server so builds, launches, UI interaction, and log capture stay pinned to one explicit simulator. ## Core Features & Use Cases - Pinned Simulator Sessions: Establish one simulator UDID via session defaults so every build, launch, screenshot, and UI action targets the same device. - Semantic UI Automation: Drive the app through accessibility snapshots and element references instead of coordinates, with wait_for_ui for asynchronous transitions. - Focused Builds, Tests, and Logs: Run build_run_sim, targeted test_sim cases, and bundle-scoped log capture for runtime diagnosis. - Use Case: After changing native code in a T3 Code Mobile feature, build and launch on a booted simulator, snapshot the UI, tap through the affected flow using element references, and capture a final screenshot proving the fix. ## Quick Start Use the ios-debugger-agent skill to build and launch the current iOS app on a booted simulator, then snapshot the UI and verify the login flow with a screenshot.

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 launch an iOS app on the Simulator with XcodeBuildMCP?

Call session_show_defaults, pick a simulator UDID from list_sims, set session defaults with the project, scheme, and simulator ID, then run build_run_sim. After launch, confirm the app state with snapshot_ui or screenshot before interacting.

How do I tap UI elements in an iOS Simulator without coordinates?

Call snapshot_ui to get the accessibility hierarchy, then tap using current elementRef values whose snapshot entries list the tap action. XcodeBuildMCP 2.6.2 does not accept coordinates, so refresh the snapshot after any navigation or layout change.

What are the requirements for running XcodeBuildMCP tools?

You need macOS 14.5 or newer, Xcode 16 or newer, and Node.js 18 or newer. The repository pins XcodeBuildMCP in .mcp.json for Claude Code and .codex/config.toml for Codex, and project MCP servers may require one-time trust approval.

Why are XcodeBuildMCP simulator or UI automation tools unavailable?

The project MCP server may not be trusted or the session predates approval, so restart the agent session after approving configuration. If tools are still missing, run npx --yes [email protected] doctor and follow its Xcode or AXe setup guidance.

When should I use build_run_sim versus launch_app_sim?

Use build_run_sim when native source, dependencies, entitlements, or project configuration changed. Use launch_app_sim when a compatible app is already installed and no native rebuild is needed, optionally reusing an artifact via get_sim_app_path and install_app_sim.