ios-debugger-agent
ios-debugger-agent automates the process of building, launching, and running your current iOS project on an active simulator instance. This skill eliminates repetitive setup steps, letting you focus on development rather than tooling. Ideal for developers seeking faster iteration cycles during iOS app testing and debugging.
ios-debugger-agent automates building, launching, and running your current iOS project on a booted simulator. The skill handles the repetitive setup steps, letting you focus on development rather than tooling. It streamlines the entire process from compilation through execution on your active simulator instance.
AI-generated summary based on this skill's SKILL.md
Install
Dimillian/Skills/ios-debugger-agent · repository language: Shell
git clone https://github.com/Dimillian/Skills
cp -r Skills/ios-debugger-agent ~/.claude/skills/ios-debugger-agentFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I debug an iOS app on simulator with ios-debugger-agent?
ios-debugger-agent automates building, launching, and running your current iOS project on a booted simulator. The skill handles the repetitive setup steps, letting you focus on development rather than tooling. It streamlines the entire process from compilation through execution on your active simulator instance.
Can ios-debugger-agent interact with simulator UI elements?
Yes. ios-debugger-agent supports full simulator UI interaction: tap buttons, type text into fields, swipe and scroll through content, and capture screenshots. These capabilities let you automate testing workflows and verify app behavior without manual interaction.
How to test iOS app on booted simulator using this tool?
ios-debugger-agent runs your current iOS scheme on an already-booted simulator. It compiles your project, launches the app, and provides access to simulator controls. You can then interact with the UI, inspect state, and capture output—all without leaving your development environment.
What debugging features does ios-debugger-agent provide?
ios-debugger-agent inspects app state, view hierarchy, and runtime behavior. It captures and analyzes console logs and app output, helping you diagnose issues quickly. You can also retrieve the app bundle ID and troubleshoot build or simulator configuration problems.
Can I take screenshots and inspect on-screen state in iOS simulator?
Yes. ios-debugger-agent captures screenshots of your iOS simulator and lets you inspect the on-screen state and view hierarchy. These tools help you verify UI rendering, validate layouts, and diagnose visual or behavioral issues during testing.
What license does ios-debugger-agent use?
ios-debugger-agent is released under the MIT license, making it free to use, modify, and distribute in both open-source and commercial projects.
SKILL.md
rendered from the published skill — quoted content, verbatim
iOS Debugger Agent
Overview
Use XcodeBuildMCP to build and run the current project scheme on a booted iOS simulator, interact with the UI, and capture logs. Prefer the MCP tools for simulator control, logs, and view inspection.
Core Workflow
Follow this sequence unless the user asks for a narrower action.
1) Discover the booted simulator
- Call
mcp__XcodeBuildMCP__list_simsand select the simulator with stateBooted. - If none are booted, ask the user to boot one (do not boot automatically unless asked).
2) Set session defaults
- Call
mcp__XcodeBuildMCP__session-set-defaultswith: projectPathorworkspacePath(whichever the repo uses)schemefor the current appsimulatorIdfrom the booted device- Optional:
configuration: "Debug",useLatestOS: true
3) Build + run (when requested)
- Call
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 2 files
ios-debugger-agent/SKILL.md
ios-debugger-agent/agents/openai.yaml