| name | ios-debugger-agent |
| description | Build, launch, inspect, and drive iOS apps with the repository-configured XcodeBuildMCP server. Use on macOS for iOS Simulator builds, focused native test runs, semantic UI automation, screenshots, logs, or debugging, including SPEG Mobile verification. |
iOS Debugger Agent
Use the repository-configured xcodebuildmcp tools instead of requiring a globally installed Codex plugin. Prefer MCP tools over raw xcodebuild, xcrun, or simctl when the client exposes them.
Confirm availability
This workflow requires macOS 14.5 or newer, Xcode 16 or newer, and Node.js 18 or newer. The repository pins XcodeBuildMCP in both .mcp.json for Claude Code and .codex/config.toml for Codex. Project MCP servers may require one-time trust or approval followed by a new session.
If the tools are missing:
- Confirm the repository is trusted and its project MCP server was approved.
- Restart or recreate the agent session after approving configuration.
- Run
npx --yes xcodebuildmcp@2.6.2 doctor when the server starts but simulator or UI-automation tools are unavailable. Follow its actionable Xcode or AXe setup guidance.
- Fall back to the pinned XcodeBuildMCP CLI or native Apple CLIs only when the current agent client cannot expose project MCP tools.
Do not ask contributors to install the OpenAI build-ios-apps plugin globally.
Establish one simulator context
- Call
session_show_defaults before discovery, build, launch, or UI work.
- Call
list_sims and select one explicit simulator UDID. Prefer a simulator that is already booted; boot an installed simulator when verification requires it, but do not create or download runtimes without user authorization.
- Call with the project or workspace, scheme, Debug configuration, simulator ID, and bundle identifier when known.