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