ios-debugger-agent

The ios-debugger-agent is a specialized engineering assistant designed to bridge the gap between AI agents and local iOS development environments. By leveraging the XcodeBuildMCP protocol, this agent enables developers to interact directly with booted iOS simulators, facilitating rapid iteration cycles without manual intervention. It is specifically tailored for engineers working on iOS projects who need to quickly validate UI changes, diagnose runtime crashes, or stream console logs directly into their agentic environment.

• Build and launch applications on booted simulators using XcodeBuildMCP.

• Perform automated UI interactions, including tapping buttons, typing text into fields, and executing common gestures like scrolls or swipes.

• Inspect the current screen state and capture screenshots to verify UI layout and element visibility.

• Manage and capture simulator logs and console output in real-time, allowing for efficient debugging of runtime behavior and stack traces.

• Identify and configure app bundle IDs, project schemes, and simulator environments dynamically.

• Ensure a simulator is already booted before invoking build or run commands; the agent will guide you through this if necessary.

• Prefer the describe_ui tool before attempting any interactive gestures to ensure accurate targeting of UI elements.

• Use the log capture functionality to pipe complex diagnostic data into the chat interface for deep analysis.

• The agent is designed to work with Xcode project/workspace paths; ensure these are correctly mapped in your session defaults.

• If build failures occur, the agent can be instructed to fallback to preferXcodebuild: true for more robust compilation attempts.

• This tool is strictly for local simulation workflows and requires an active Xcode environment configured for the target project.