/xcodebuildmcp-cli

name: xcodebuildmcp-cli
description: Official skill for the XcodeBuildMCP CLI. Use when doing iOS/macOS/watchOS/tvOS/visionOS work (build, test, run, debug, log, UI automation).

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.