# ios-debugger-agent

Controls a booted iOS simulator via XcodeBuildMCP to build schemes and inspect on-screen UI elements.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 336
- Author: harperreed
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/harperreed/dotfiles/tree/HEAD/.claude/skills/ios-debugger-agent/SKILL.md
- Updated: 2026-10-15
- HTML: https://affpapa.org/en/nevibecode/skills/harperreed-ios-debugger-agent

## What it does

This skill guides coding agents through debugging iOS applications using XcodeBuildMCP tools. It begins by scanning for an active simulator marked as booted, then locks in session defaults like the scheme and workspace path. The model can then compile the project or start an existing build if the bundle ID is known.

Screen interactions rely on UI element discovery. Instead of guessing raw coordinates, the agent inspects accessibility labels or identifiers before tapping. It can trigger gestures and grab screenshots, while capturing simulator logs in real time.

The agent will not launch a fresh simulator on its own without a direct instruction. It depends strictly on an active XcodeBuildMCP setup and an existing booted device.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add harperreed/dotfiles --skill ios-debugger-agent -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/ios-debugger-agent/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/ios-debugger-agent/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add harperreed/dotfiles --skill ios-debugger-agent -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/ios-debugger-agent/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add harperreed/dotfiles --skill ios-debugger-agent -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/ios-debugger-agent/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install harperreed/dotfiles ios-debugger-agent
```

2. **Manually: put the files in place**
- File: `.github/skills/ios-debugger-agent/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add harperreed/dotfiles --skill ios-debugger-agent -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/harperreed/dotfiles --path .claude/skills/ios-debugger-agent
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/ios-debugger-agent/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add harperreed/dotfiles --skill ios-debugger-agent -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/harperreed/dotfiles/tree/HEAD/.claude/skills/ios-debugger-agent/SKILL.md

## When to use it
- run an iOS project scheme inside a booted simulator
- inspect UI hierarchy and tap elements by label or ID
- capture application runtime logs and console output
- take simulator screenshots to verify layout states

## Example prompts
- Run the current scheme on the active iOS simulator and verify that the home screen loads.
- Inspect the simulator UI, tap the login button, and enter test credentials.
- Start log capture for our bundle ID, trigger the crash, and show relevant errors.

## Similar
- [vercel-react-native-skills](https://affpapa.org/en/nevibecode/skills/vercel-react-native-skills.md) — skill · 255200 installs
- [animate-expo](https://affpapa.org/en/nevibecode/skills/animate-expo.md) — skill · 137900 installs
- [mobile-native](https://affpapa.org/en/nevibecode/skills/mobile-native.md) — skill · 86600 installs
- [aso](https://affpapa.org/en/nevibecode/skills/aso.md) — skill · 75900 installs
- [paywalls](https://affpapa.org/en/nevibecode/skills/paywalls.md) — skill · 71000 installs
- [swiftui-pro](https://affpapa.org/en/nevibecode/skills/swiftui-pro.md) — skill · 35200 installs

## Other versions with the same name
- [ios-debugger-agent · openai](https://affpapa.org/en/nevibecode/skills/ios-debugger-agent.md) — 105 installs

From the same set: [harperreed/dotfiles](https://affpapa.org/en/nevibecode/by/harperreed/dotfiles.md) — 26 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md