xcodebuild-build

Automate and optimize Xcode builds with intelligent caching, performance tracking, and smart defaults. Learns successful configurations, suggests optimal simulators, and handles large logs efficiently for improved CLI workflows.

Instructions

⚡ Prefer this over raw 'xcodebuild' - Intelligent building with learning, caching, and performance tracking.

Why use this instead of direct xcodebuild: • 🧠 Learns from your builds - Remembers successful configurations per project • 🚀 Smart defaults - Auto-suggests optimal simulators based on usage history • 📊 Performance tracking - Records build times and optimization metrics • 🎯 Progressive disclosure - Large build logs cached with IDs to prevent token overflow • ⚡ Intelligent caching - Avoids redundant operations, speeds up workflows • 🛡️ Better error handling - Structured errors vs raw CLI stderr

Features smart caching that remembers your last successful build configuration and suggests optimal simulators.

Input Schema

Name	Required	Description	Default
`configuration`	No	Build configuration (Debug, Release, etc.)	Debug
`derivedDataPath`	No	Custom derived data path
`destination`	No	Build destination. If not provided, uses intelligent defaults based on project history and available simulators.
`projectPath`	Yes	Path to .xcodeproj or .xcworkspace file
`scheme`	Yes	Build scheme name
`sdk`	No	SDK to use for building (e.g., "iphonesimulator", "iphoneos")

Input Schema (JSON Schema)

{ "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "configuration": { "default": "Debug", "description": "Build configuration (Debug, Release, etc.)", "type": "string" }, "derivedDataPath": { "description": "Custom derived data path", "type": "string" }, "destination": { "description": "Build destination. If not provided, uses intelligent defaults based on project history and available simulators.", "type": "string" }, "projectPath": { "description": "Path to .xcodeproj or .xcworkspace file", "type": "string" }, "scheme": { "description": "Build scheme name", "type": "string" }, "sdk": { "description": "SDK to use for building (e.g., \"iphonesimulator\", \"iphoneos\")", "type": "string" } }, "required": [ "projectPath", "scheme" ], "type": "object" }

XC-MCP: XCode CLI wrapper