ios-debugger

Build, run, and debug iOS applications from the command line.

16|2|Updated Nov 9, 2025
One-click install
npx skills add https://github.com/maroffo/claude-forge --skill ios-debugger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ios-debugger
Source: https://github.com/maroffo/claude-forge/tree/main/skills/ios-debugger
Command: npx skills add https://github.com/maroffo/claude-forge --skill ios-debugger

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill allows developers to build, run, and debug iOS applications directly from the command line, bypassing the need for the Xcode graphical user interface.

Core Features & Use Cases

  • Build & Run: Compile and deploy iOS apps to a simulator without opening Xcode.
  • Simulator Automation: Programmatically interact with the iOS Simulator, including tapping, typing, and taking screenshots.
  • Log Capture: Stream and filter application logs directly from the simulator.
  • Use Case: Automate the build, test, and deployment pipeline for an iOS app in a CI/CD environment, or quickly test app behavior without the overhead of launching Xcode.

Quick Start

Build and run the MyApp application on the booted iPhone 16 Pro simulator.

Frequently Asked Questions about ios-debugger

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

FAQPage Schema
How do I build and run iOS apps on a simulator from the command line?

Build and run iOS apps on a simulator from the command line by compiling and deploying applications directly, bypassing the Xcode UI entirely. This enables automated deployment workflows for development and CI/CD pipelines.

Can I automate iOS simulator interactions like tapping and typing without Xcode?

Yes, you can automate iOS simulator interactions without Xcode by using CLI commands to programmatically trigger tapping, typing, and taking screenshots. This allows for automated UI testing and behavior validation.

What is the best way to capture and stream iOS application logs in a CI/CD pipeline?

The best way to capture and stream iOS application logs in a CI/CD pipeline is using command-line tools that filter and stream logs directly from the booted simulator, eliminating the need to launch the Xcode UI.

Do I need Xcode installed to debug iOS apps via the command line?

Yes, you need Xcode installed to debug iOS apps via the command line because the underlying tools rely on Xcode's core simulator and build capabilities. Optionally, XcodeBuildMCP can be used for enhanced integration.

How does CLI debugging for iOS compare to using the Xcode GUI?

CLI debugging for iOS compares to the Xcode GUI by eliminating graphical interface overhead, allowing developers to quickly compile, deploy, and interact with simulators programmatically, which is ideal for automated CI/CD environments.

When should I avoid using a CLI approach for iOS app debugging?

You should avoid using a CLI approach for iOS app debugging when you require deep visual profiling or complex storyboard editing, as command-line tools focus on build execution, simulator automation, and log capturing.