xcodebuildmcp-cli

SKILL.md

XcodeBuildMCP CLI

Use XcodeBuildMCP tools via the xcodebuildmcp executable instead of raw xcodebuild, xcrun, or simctl.

Step 1: Ensure the CLI Exists

Check availability:

xcodebuildmcp --help

If missing, install with one of:

brew tap getsentry/xcodebuildmcp
brew install xcodebuildmcp

npm install -g xcodebuildmcp@latest

Re-check after install:

xcodebuildmcp --help

Step 2: Use Help-First Discovery

Discover workflows and arguments from the CLI itself:

xcodebuildmcp --help
xcodebuildmcp tools
xcodebuildmcp <workflow> --help
xcodebuildmcp <workflow> <tool> --help

Use this discovery path instead of memorizing static tool lists.

Step 3: Keep Execution Minimal

Choose the smallest command sequence that satisfies the request.

Prefer direct workflow commands over manual multi-step chains unless explicitly requested.

For simulator run intent, prefer the combined build-and-run command.

Do not chain build then build-and-run unless explicitly requested.

Capability Overview

xcodebuildmcp supports:

simulator and device build/test/run

debugging and log capture

UI automation

project discovery and scaffolding

session defaults and workflow configuration

Exit Criteria

CLI presence is verified or installation steps are provided.

Commands are discovered via --help / tools.

Session defaults are checked before first build/run/test action.