iOS Development

A tech pack that integrates Xcode build/test workflows, simulator management, and Apple documentation into Claude Code.

Built for the mcs configuration engine.

identifier: ios
requires:   mcs >= 2026.3.6

---

What Is This?

This pack gives Claude Code full awareness of your iOS development environment — it can build, test, and run your app, manage simulators, and search Apple documentation, all without ever touching raw xcodebuild commands.

On session start, the pack detects your booted simulator and reports its UUID. During mcs configure, it auto-detects your .xcodeproj or .xcworkspace and generates the XcodeBuildMCP configuration.

---

What's Included

MCP Servers

Server	Description
XcodeBuildMCP	Build, test, run, and manage iOS simulators through Xcode
Sosumi	Apple developer documentation search

Skills

Skill	Description
xcodebuildmcp	Loads XcodeBuildMCP tool catalog and workflow guidance

Session Hooks

Hook	Event	What It Does
ios-simulator-status.sh	SessionStart	Detects booted iOS simulator and reports its name + UUID

Templates (CLAUDE.local.md)

Section	Instructions
ios	Use booted simulator by UUID, all builds via XcodeBuildMCP, never run xcrun/xcodebuild directly, prefer snapshot_ui over screenshot
xcodebuildmcp	XcodeBuildMCP project path and platform configuration

Configuration Script

Script	When	What It Does
configure-xcode.sh	mcs configure	Creates .xcodebuildmcp/config.yaml with enabled workflows, project path, and platform settings

---

Installation

Prerequisites

• macOS (Apple Silicon or Intel)
• Claude Code CLI
• Xcode Command Line Tools (xcode-select --install)

Setup

# 1. Install mcs
brew install mcs-cli/tap/mcs

# 2. Register this tech pack
mcs pack add mcs-cli/ios

# 3. Sync your project
cd ~/Developer/my-ios-project
mcs sync

# 4. Verify everything is healthy
mcs doctor

During mcs sync, you'll be prompted for:

Prompt	What It Does	Default
Xcode project	Auto-detects *.xcodeproj / *.xcworkspace files for XcodeBuildMCP	(detected)

---

Directory Structure

ios/
├── techpack.yaml                  # Manifest — defines all components
├── hooks/
│   └── ios-simulator-status.sh    # Booted simulator detection
├── templates/
│   ├── ios.md                     # iOS rules for CLAUDE.local.md
│   └── xcodebuildmcp.md          # XcodeBuildMCP project configuration
└── scripts/
    └── configure-xcode.sh         # Creates .xcodebuildmcp/config.yaml

---

You Might Also Be Interested In

Pack	Description
dev	Foundational settings, plugins, git workflows, and code navigation
memory	Persistent memory and knowledge management across sessions

---

Links

• MCS — the configuration engine
• Creating Tech Packs — guide for building your own
• Tech Pack Schema — full YAML reference

---

License

MIT