Xcode Runner — Development agent for Claude Code
Runs Xcode apps on simulators, physical devices, or macOS.
How to install Xcode Runner
Installs to ~/.claude/agents/wyattjoh-skills-xcode-runner.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/wyattjoh/skills/HEAD/agents/xcode-runner.md -o ~/.claude/agents/wyattjoh-skills-xcode-runner.md Restart Claude Code, or start a new session, for it to be picked up.
What Xcode Runner does
name: xcode-runner description: 'Runs Xcode apps on simulators, physical devices, or macOS. Determines if a rebuild is needed, delegates builds to xcode-builder, then installs, launches, and optionally streams console logs. Use when asked to "run my app", "launch on device", "test on simulator", "run on Mac", or "stream logs".' tools: "Bash, Read, Grep, Glob, Task" model: sonnet
You are a run orchestrator for Xcode/Swift projects. Your role is to get an app running on a device or simula
Alternatives in Development
- Turbo Agent — Implements Turbo Drive, Turbo Frames, and Turbo Streams for fast, responsive Rails applications with minimal J 652 ★
- Synthesis Composer — Optional decision helper that turns Vestige retrievals into concise recommendations 632 ★
- Helm Conductor — Use this agent to orchestrate engineering work cycles — decide what to work on next, sequence stories and feat 523 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Crashlytics Triage Agent
Use this agent when you have a crash log, stack trace, or ANR report from Firebase Crashlytics, Play Console,
Flutter Device Orchestrator
Use this agent when managing iOS simulators and Android emulators for Flutter development. Specializes in devi
Craft Review
Reviews prose for craft depth — aphoristic destinations, naming opportunities, central-point dwelling, structu
Device Library Expert
Device library creation specialist. Use when creating new device libraries, documenting MIDI implementations,
Android Mod
Use PROACTIVELY and automatically — do not wait to be asked — for Android rooting, debloat, flashing, and flee
Android Pwn
Use PROACTIVELY and automatically — do not wait to be asked — for Android rooting/jailbreaking/device-hacking
Related Skills
iOS Trace
Agent Skill: closed-loop performance optimization for iOS & iPadOS apps — headless xctrace profiling on physic
Haptic Bridge
Local daemon that turns Claude Code / Codex lifecycle events (permission prompt, waiting for input, turn done)
Xcindex Setup
Bootstrap xcindex in the current project — verifies the Swift binary, locates the Xcode project, optionally bu