xcodelisted
Install: claude install-skill app-builders-club/mvp-builder
# Xcode
Two complementary surfaces:
1. **Bridge** — `xcode-cli` + MCP tools talking to a live, open Xcode workspace via SourceKit and AppleScript. Sees indexed symbols, navigator issues, the last build's diagnostics, project group membership. Required when you need live IDE state.
2. **CLI** — `xcodebuild` + `xcrun simctl`, standalone Xcode command-line tools. Run headless, no IDE required. Required for simulator lifecycle, screenshots, log streaming, archives, headless builds, and anything scriptable.
Most non-trivial sessions touch both. Pick per operation.
## When to use
**Bridge territory:**
- Build / Run / Test the project currently open in Xcode
- Diagnose compile, type, or link errors
- Inspect symbols, files, or directories as Xcode sees them
- Edit Swift / Objective-C / resource files inside the project group (membership stays correct)
- Render a SwiftUI `#Preview` to a PNG
- Execute a one-shot Swift expression in a file's type context
- Search Apple's documentation indexed locally
**CLI territory:**
- Boot, shutdown, erase, or create iOS simulators
- Build to a specific simulator UDID or OS version, headless or in CI
- Install, launch, terminate apps on a simulator
- Take screenshots, record video, stream app logs
- Send push notifications, set location, override status bar, grant privacy permissions
- Open URLs / deep links in the simulator
- Build archives and export IPAs for distribution
**Do NOT use for:**
- Generating Swift code with no project to anchor