ios-simulator-debugger

ios-simulator-debugger is a skill for Claude Code, Codex from Xopoko/build-swift-apps. It costs 49 tokens per session (561 once invoked), scanned A, original, MIT.

A guide for building, launching, inspecting, and debugging iPhone and iPad apps in Apple's Simulator, a desktop tool that runs virtual iOS devices. It covers visible UI checks as well as logs and automated interaction.

In plain words
What is it for?
Use it to compile and run an iOS app, inspect its UI tree, interact with controls, capture screenshots, and read logs. It is also for headless simulator checks when the user does not need to see the app.
Why use it?
It removes the guesswork from finding the right simulator, build settings, app identifier, and diagnostic output. It also prevents attempts to run Apple-only tools on unsupported computers.

Skill for Claude CodeCodex

Written for Claude Code and Codex: shipped in a Claude Code plugin, but also agents/openai.yaml present.

Part of the build-swift-apps plugin — 61 skills, 3 commands, 3 MCP servers shipped together

Good fit Use it to compile and run an iOS app, inspect its UI tree, interact with controls, capture screenshots, and read logs. It is also for headless simulator checks when the user does not need to see the app.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/xopoko/build-swift-apps/ios-simulator-debugger
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add Xopoko/build-swift-apps --skill ios-simulator-debugger
Clone the repo
git clone --depth 1 https://github.com/Xopoko/build-swift-apps

Made for: Claude Code, Codex.

Or install build-swift-apps, the plugin that ships this one along with the rest of its 61 skills, 3 commands, 3 MCP servers.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for ios-simulator-debugger

README.md
[![agentmods](https://agentmods.dev/badge/skills/xopoko/build-swift-apps/ios-simulator-debugger.svg)](https://agentmods.dev/skills/xopoko/build-swift-apps/ios-simulator-debugger)
Your own site
<a href="https://agentmods.dev/skills/xopoko/build-swift-apps/ios-simulator-debugger"><img src="https://agentmods.dev/badge/skills/xopoko/build-swift-apps/ios-simulator-debugger.svg" alt="Measured on agentmods" height="20"></a>
Per session 49 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 561 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00049 $0.00561
Opus 5 $0.00024 $0.00280
Sonnet 5 $0.00010 $0.00112
Haiku 4.5 $0.00005 $0.00056

Measured 8d ago against content hash f8dcd16037f2, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

ios-simulator-debugger scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/ios-simulator-debugger/SKILL.md · 41 lines

How it starts

The opening of the file, as written. The whole thing — 41 lines — stays where its author put it; the contents beside it link to each section on GitHub.

iOS Simulator Debugger

Before invoking Apple-only binaries, confirm the execution context is macOS. From Windows or Linux, run those steps in a Mac SSH project or through an already configured remote transport; do not retry missing Apple binaries locally.

Use the configured XcodeBuildMCP transport for simulator control, build/run, UI inspection, screenshots, interaction, and logs. Tool namespaces vary by agent, so the names below are the canonical XcodeBuildMCP tool names.

If the user should see or interact with the running app, prefer ios-simulator-browser after this skill has selected or launched the Simulator. Keep this skill focused on build/run, logs, bundle IDs, UI tree inspection, and headless simulator automation.

Workflow

  1. Inspect current defaults with session_show_defaults before the first build, run, or test operation.
  2. Discover a booted simulator with list_sims. If none is booted, ask the user to boot one unless they asked you to boot it.
  3. Set defaults with session_set_defaults: projectPath or workspacePath, scheme, simulatorId, optional configuration: "Debug" and useLatestOS: true.
  4. Build/run with build_run_sim when requested. If the build fails, inspect output and retry only when justified, optionally with preferXcodebuild: true.
  5. After a successful run, verify launch with snapshot_ui or screenshot before UI interaction.
  6. If only launch is requested, use launch_app_sim. If bundle id is unknown, call get_sim_app_path then get_app_bundle_id.

Interaction

  • Snapshot before acting: snapshot_ui.
  • Tap by id or label first; coordinates only when needed.
  • Type after focusing a field with type_text.
  • Use gesture for scrolls and edge swipes.
  • Capture visual proof with screenshot.

Logs

Use build_run_sim or launch_app_sim; current XcodeBuildMCP releases capture runtime logs automatically and return the log path in the structured result. Read that returned file and summarize important lines. Relaunch through the same tool when fresh console output is required.

Read the full file on GitHub · 41 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 41 lines · 49 tokens per session scan A f8dcd16037f2

Subscribe to this mod's changes

ios-simulator-debugger is a skill published in the GitHub repository Xopoko/build-swift-apps (45 stars, last pushed 10d ago), licensed MIT. It adds 49 tokens to every session and 561 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

firebase-crashlytics

Use when implementing crash reporting, capturing fatal/non-fatal errors, recording isolate/async exceptions, customizing reports, or uploading obfuscated symbols.

evanca/flutter-ai-rules · 34 tokens

flutter-errors

Use when hitting layout errors (RenderFlex overflow, unbounded constraints, RenderBox not laid out), scroll errors, or setState-during-build errors.

evanca/flutter-ai-rules · 34 tokens

push-notification-tester

Test VoIP push notifications for Telnyx WebRTC iOS (APNs) and Android (FCM) apps. Use when debugging push notification delivery, validating certificate/credential setup, or testing that a device receives VoIP pushes correctly.

team-telnyx/ai · 55 tokens

mobile-emulator-start

Boot Android emulator + Metro (Expo / bare RN) in order: inspect IDE terminals, kill stale ports, pick an AVD. Use when "start Metro", "start emulator", "Cannot connect to Expo", or a stuck dev loop. QA on the running emulator → mobile-emulator-test.

kensaurus/cursor-kenji · 65 tokens

apple-cleanup

Exhaustive engineering hardening of an iOS app. Reviews for Swift 6 compliance, crash risks, App Store rejection risks, and tech debt; builds a surgical plan; dispatches parallel subagents to fix all P0-P2 issues; then pushes an alpha to TestFlight. Use for pre-submission cleanup and code hardening, not design polish.

markdavidgan/apple-dev-skills · 77 tokens

apple-polish

Design and keynote-readiness craftsmanship review of an iOS app. Evaluates through Jony Ive (visual obsession) and Steve Jobs (demo readiness) perspectives, presents prioritized findings, then orchestrates parallel agents to fix selected issues and push a TestFlight build. Use for design polish, not engineering bugs.

markdavidgan/apple-dev-skills · 65 tokens