ios-debugger-agent

Automate iOS app builds, launches, and log capture on booted simulators.

2|Updated Mar 29, 2026
One-click install
npx skills add https://github.com/NagyVikt/codex-plugins --skill ios-debugger-agent-nagyvikt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ios-debugger-agent
Source: https://github.com/NagyVikt/codex-plugins/tree/main/plugins/build-ios-apps/skills/ios-debugger-agent
Command: npx skills add https://github.com/NagyVikt/codex-plugins --skill ios-debugger-agent-nagyvikt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill removes the friction from the iOS development loop by automating the build, launch, and inspection process on the simulator, allowing developers to focus on logic rather than manual environment management.

Core Features & Use Cases

  • Automated Build & Launch: Orchestrates the entire lifecycle of building and running an iOS project on a booted simulator.
  • UI Inspection & Interaction: Provides tools to describe UI elements, perform gestures, and capture screenshots for rapid visual verification.
  • Log Analysis: Captures and summarizes console output and system logs to diagnose runtime issues efficiently.
  • Use Case: A developer needs to verify a new feature on a specific simulator; this skill handles the build, launches the app, and captures the logs automatically.

Quick Start

Use the ios-debugger-agent to build and launch the current project on the booted simulator and capture the console logs.

Frequently Asked Questions about ios-debugger-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate the iOS app build and launch process on a local simulator?

Automating iOS simulator build and launch processes requires orchestrating the application lifecycle using XcodeBuildMCP. This skill handles the automated build, deployment, and execution on a booted simulator, eliminating manual environment management.

What's the best way to capture console logs and diagnose runtime issues on an iOS simulator?

Capturing iOS simulator console logs for runtime diagnostics is done by executing inspection commands via XcodeBuildMCP. This skill automatically captures and summarizes system logs to help developers efficiently diagnose runtime issues.

Can I perform UI interaction and capture screenshots during iOS simulator debugging?

Performing UI interaction and capturing screenshots during iOS simulator debugging is supported natively. The skill provides tools to describe UI elements, execute gestures, and grab screenshots for rapid visual verification of your mobile application.

Do I need an active Xcode environment and a booted simulator to use this iOS debugging automation?

An active Xcode environment and a booted iOS simulator are strictly required to execute build and inspection commands. This skill relies on the local XcodeBuildMCP setup to manage the mobile development workflow and deploy applications.

How does automating iOS deployment with XcodeBuildMCP compare to manual Xcode debugging?

Automating iOS deployment with XcodeBuildMCP streamlines the entire build, launch, and inspection loop, unlike manual Xcode debugging. It removes friction by handling environment management, UI inspection, and log capture automatically for mobile workflows.

Why does iOS simulator automation fail when running build and launch commands?

iOS simulator automation fails when the local environment lacks an active Xcode setup or a booted simulator. You must ensure the Xcode environment is running and the target simulator is booted before executing automated build and diagnostics commands.