tools.json

{
  "tools": [
    {
      "name": "AddEntitlement",
      "title": "AddEntitlement",
      "description": "Add a new entitlement to the project's entitlements file.\n\nMost Apple APIs do NOT require an entitlement. Only use this tool when a\nfeature requires a code-signing entitlement. These are things like access\nto protected hardware, sandboxed data stores shared between apps, paid\ntransaction processing, or privileged inter-process communication.\n\nDo NOT use this tool or add an entitlement for:\n- Adding UI components or using standard frameworks (SwiftUI, UIKit, MapKit, AVFoundation, CoreLocation, etc.)\n- Privacy usage descriptions — those are Info.plist keys, not entitlements. You should use the AddInfoPlist tool.\n- General feature development that doesn't involve a restricted system capability\n\nWhen in doubt, do NOT call this tool or add an entitlement. If you run\ninto debugging issues after adopting a new API — such as failures\nconnecting to system XPC services — you can add the entitlement then.\n\nParameters:\n    - targetName: The name of the Xcode target to add the entitlement to. Use another tool to discover the target names if you don't already know them.\n    - entitlementKey: The entitlement key you want to add.\n    - entitlementValueType: The type of the value — 'bool', 'string', 'int', 'stringArray', or 'dictionary'.\n    - entitlementValue: The value as a string (for bool, string, or int types). For bool, pass 'true' or 'false'.\n    - entitlementValueItems: Array of strings (only for stringArray type).\n    - entitlementDictionaryItems: JSON-encoded dictionary (only for dictionary type).\n\nNote: It is IMPORTANT that you do not edit the entitlement file directly unless told to. ALWAYS call this tool if you need to change the entitlement file.",
      "inputSchema": {
        "properties": {
          "entitlementDictionaryItems": {
            "type": "string",
            "description": "A JSON-encoded string representing a dictionary. Required when entitlementValueType is 'dictionary'. Example: '{\"key\":\"value\"}'."
          },
          "entitlementKey": {
            "type": "string",
            "description": "The entitlement key you want to add."
          },
          "entitlementValue": {
            "type": "string",
            "description": "The entitlement value as a string. Required when entitlementValueType is 'bool', 'string', or 'int'. For bool, pass 'true' or 'false'. For int, pass the number as a string. Not used for stringArray or dictionary types."
          },
          "entitlementValueItems": {
            "type": "array",
            "description": "Array of string values. Required when entitlementValueType is 'stringArray'.",
            "items": {
              "type": "string"
            }
          },
          "entitlementValueType": {
            "type": "string",
            "description": "The type of the entitlement value. Most entitlements are 'bool' (pass entitlementValue 'true'). Some are 'string' (pass the value in entitlementValue). A few are 'stringArray' (pass values in entitlementValueItems instead). Use 'dictionary' for entitlements whose value is a plist dictionary (pass JSON in entitlementDictionaryItems).",
            "enum": [
              "bool",
              "string",
              "int",
              "stringArray",
              "dictionary"
            ]
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier."
          },
          "targetName": {
            "type": "string",
            "description": "The name of the Xcode target to add the entitlement to. Use another tool (e.g. GetTargetBuildSettings) to discover target names if they are not already known."
          }
        },
        "required": [
          "tabIdentifier",
          "targetName",
          "entitlementKey",
          "entitlementValueType"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "errorDescription": {
            "type": "string",
            "description": "An optional description of the error when trying to add the entitlement. This string will be available if result is false."
          },
          "result": {
            "type": "boolean",
            "description": "A boolean to indicate if adding the entitlement was successful or not."
          }
        },
        "required": [
          "result"
        ],
        "type": "object"
      }
    },
    {
      "name": "AddInfoPlist",
      "title": "AddInfoPlist",
      "description": "Add or update an Info.plist key in the project.\n\nUse this tool for app configuration metadata such as:\n- Privacy usage descriptions (e.g. NSCameraUsageDescription, NSLocationWhenInUseUsageDescription)\n- App Transport Security settings\n- Supported interface orientations\n- URL schemes and document types\n- Background modes\n- Bundle display name, version, or other app metadata\n\nThis is NOT for entitlements. If you need a restricted system capability\ngated by code signing (like Push Notifications, App Groups, or iCloud),\nuse the AddEntitlement tool instead.\n\nParameters:\n- targetName: The name of the Xcode target to add the Info.plist key to. Use another tool to discover the target names if you don't already know them.\n- infoPlistKey: The key for the info.plist value you want to add.\n- infoPlistValueType: The type of the value — 'bool', 'string', 'int', 'stringArray', or 'dictionaryArray'.\n- infoPlistValue: The value as a string (for bool, string, or int types). For bool, pass 'true' or 'false'.\n- infoPlistValueItems: Array of strings (only for stringArray type).\n- infoPlistDictionaryItems: JSON-encoded array of dictionaries (only for dictionaryArray type).\n\nIMPORTANT: Do NOT modify the Info.plist file directly. Always use this tool\nto add or edit Info.plist keys, even if the project has GENERATE_INFOPLIST_FILE enabled.",
      "inputSchema": {
        "properties": {
          "infoPlistDictionaryItems": {
            "type": "string",
            "description": "A JSON-encoded string representing an array of dictionaries. Required when infoPlistValueType is 'dictionaryArray'. Example: '[{\"NSAllowsArbitraryLoads\": true}]'"
          },
          "infoPlistKey": {
            "type": "string",
            "description": "The Info.plist key to add or change"
          },
          "infoPlistValue": {
            "type": "string",
            "description": "The value as a string. Required when infoPlistValueType is 'bool', 'string', or 'int'. For bool, pass 'true' or 'false'. For int, pass the number as a string. Not used for stringArray or dictionaryArray types."
          },
          "infoPlistValueItems": {
            "type": "array",
            "description": "Array of string values. Required when infoPlistValueType is 'stringArray'.",
            "items": {
              "type": "string"
            }
          },
          "infoPlistValueType": {
            "type": "string",
            "description": "The type of the Info.plist value. Common types are 'string' (for privacy descriptions, display names) and 'bool' (for boolean flags). Use 'stringArray' for lists and 'dictionaryArray' for complex structures like App Transport Security settings.",
            "enum": [
              "bool",
              "string",
              "int",
              "stringArray",
              "dictionaryArray"
            ]
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          },
          "targetName": {
            "type": "string",
            "description": "The name of the Xcode target whose Info.plist key should be added or updated. Use another tool (e.g. GetTargetBuildSettings) to discover target names if they are not already known."
          }
        },
        "required": [
          "tabIdentifier",
          "targetName",
          "infoPlistKey",
          "infoPlistValueType"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "errorDescription": {
            "type": "string",
            "description": "An optional description of the error when trying to add the info.plist. This string will be available if result is false."
          },
          "result": {
            "type": "boolean",
            "description": "Whether or not adding/updating the info.plist was successful."
          }
        },
        "required": [
          "result"
        ],
        "type": "object"
      }
    },
    {
      "name": "BuildProject",
      "title": "Build Project",
      "description": "Builds an Xcode project and waits until the build completes.",
      "inputSchema": {
        "properties": {
          "buildForTesting": {
            "type": "boolean",
            "description": "Whether to also build test targets that would not usually be included in a regular build"
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          }
        },
        "required": [
          "tabIdentifier"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "buildResult": {
            "type": "string",
            "description": "The message indicating the result of the build operation"
          },
          "elapsedTime": {
            "type": "number",
            "description": "The time it took to finish the build, in seconds"
          },
          "errors": {
            "type": "array",
            "description": "List of build errors",
            "items": {
              "properties": {
                "classification": {
                  "type": "string",
                  "description": "The type of error (error, warning, etc.)"
                },
                "filePath": {
                  "type": "string",
                  "description": "The file path where the error occurred"
                },
                "lineNumber": {
                  "type": "integer",
                  "description": "The line number where the error occurred"
                },
                "message": {
                  "type": "string",
                  "description": "The error message"
                }
              },
              "required": [
                "classification",
                "message"
              ],
              "type": "object"
            }
          },
          "fullLogPath": {
            "type": "string",
            "description": "Path of the full log in textual format, containing the complete command lines and any output from the build tasks"
          }
        },
        "required": [
          "buildResult",
          "errors",
          "fullLogPath"
        ],
        "type": "object"
      }
    },
    {
      "name": "DeviceInteractionEndSession",
      "title": "End Device Interaction Session",
      "description": "Closes previous device session created in DeviceInteractionStartSession.\n        \nCall this action once you have finished interacting with a device.\nKeeping a device interaction session alive is expensive and affects the user-facing UI.\nIt is crucial to close the session when not in use.",
      "inputSchema": {
        "properties": {
          "interactionSessionKey": {
            "type": "string",
            "description": "Device Interaction session to close. Taken from Start Device Interaction Session"
          }
        },
        "required": [
          "interactionSessionKey"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "userMessage": {
            "type": "string",
            "description": "A summary of the action"
          }
        },
        "required": [
          "userMessage"
        ],
        "type": "object"
      }
    },
    {
      "name": "DeviceInteractionInstallAndRun",
      "title": "Prepare for device interaction: install and start application on a device",
      "description": "Builds, installs, and starts the current application on the currently targeted device.\n\nCall this action to install the application on the currently targeted device and start it\nso subsequent interaction calls will have the most up to date version.\nInvoke this every time you modify a project, change the target device, or the previous\ndebug session has been disconnected and application logs are missing.",
      "inputSchema": {
        "properties": {
          "commandLineArguments": {
            "type": "array",
            "description": "Arguments that the application should be run with. Can include '$(inherited)' placeholder string for scheme-provided arguments",
            "items": {
              "type": "string"
            }
          },
          "environmentVariables": {
            "type": "object",
            "description": "Environment variables that the application should be run with. Can contain '$(inherited)' as a key to include scheme-provided environment variables"
          },
          "interactionSessionKey": {
            "type": "string",
            "description": "Device Interaction session identifier that initiates this call. Taken from Start Device Interaction Session"
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          }
        },
        "required": [
          "tabIdentifier",
          "interactionSessionKey"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "userMessage": {
            "type": "string",
            "description": "A summary of the action"
          }
        },
        "required": [
          "userMessage"
        ],
        "type": "object"
      }
    },
    {
      "name": "DeviceInteractionStartSession",
      "title": "Start Device Interaction Session",
      "description": "Prepares a runtime for iOS interaction. This should be called as early as possible if device interaction will be needed.\n\nInvoke this tool if you are going to perform runtime verification on a device/simulator.\nThis tool finds and (if necessary) boots a desired device. The action may take time,\nso this should be invoked early in the process to prepare the device in parallel with ongoing feature development.\nKeeping the session open is expensive, so call DeviceInteractionEndSession to close the session once\ninteraction is finished.\n\nDo NOT call this if the application you are working on cannot be built and installed on an iOS device.",
      "inputSchema": {
        "properties": {
          "deviceIdentifier": {
            "type": "string",
            "description": "The UUID/ECID/name/OS version/type of the device to perform interaction. Accepts any values and tries to match the best candidate."
          },
          "sessionIdentifier": {
            "type": "string",
            "description": "Unique human-friendly identifier for this session (e.g. \"Verify Login Flow\"). Used in logs and UI - use Title Case."
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          }
        },
        "required": [
          "tabIdentifier",
          "sessionIdentifier"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "deviceIsSimulator": {
            "type": "boolean",
            "description": "true if the device for this session is a simulator, otherwise false"
          },
          "deviceUUID": {
            "type": "string",
            "description": "UUID of the device to be used for the interaction session"
          },
          "interactionSessionKey": {
            "type": "string",
            "description": "A secret key to identify the interaction session"
          },
          "skillToTrigger": {
            "type": "string",
            "description": "The name of the skill that will handle the next step(s)"
          },
          "summary": {
            "type": "string",
            "description": "Notes about the session and guidance on next steps for a caller"
          }
        },
        "required": [
          "summary",
          "skillToTrigger",
          "interactionSessionKey",
          "deviceUUID",
          "deviceIsSimulator"
        ],
        "type": "object"
      }
    },
    {
      "name": "DeviceInteractionSynthesize",
      "title": "Perform single device interaction and fetch device state",
      "description": "Synthesizes device events (tap, swipe, type, etc.) on a physical device or simulator\nand captures the resulting state.\n\nThis action provides a unified interface for device interaction. After executing the\nspecified interaction command, it captures a screenshot and UI hierarchy, returning\npaths to both files.\nUse this to:\n- Tap UI elements at specific coordinates\n- Swipe/scroll through content\n- Type text into fields\n- Press hardware buttons\n- Capture current device state (screenshot + hierarchy)\n- Change device orientation\n\nAlways use positions based on the most recent hierarchy dump. Never try to guess positions from a screenshot only.",
      "inputSchema": {
        "properties": {
          "interactSessionKey": {
            "type": "string",
            "description": "Device Interaction session key to work with. Taken from Start Device Interaction Session"
          },
          "interactionCommand": {
            "type": "string",
            "description": "The interaction command to execute (e.g., 't 100 200' for tap)"
          }
        },
        "required": [
          "interactSessionKey"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "applicationState": {
            "type": "string",
            "description": "State of the run application: NotRun, Running, Stopped, Crashed, Disconnected."
          },
          "hierarchyPath": {
            "type": "string",
            "description": "Path to the captured UI hierarchy file (incl. device orientation). If missing, retry as that might be AX transient issue"
          },
          "logsPath": {
            "type": "string",
            "description": "Path to the file where collected console logs of the application are stored"
          },
          "screenshotPath": {
            "type": "string",
            "description": "Path to the captured full-size screenshot"
          },
          "thumbnailScreenshotPath": {
            "type": "string",
            "description": "Path to a screenshot file with small resolution"
          }
        },
        "required": [
          "thumbnailScreenshotPath",
          "screenshotPath",
          "hierarchyPath",
          "logsPath",
          "applicationState"
        ],
        "type": "object"
      }
    },
    {
      "name": "DocumentationSearch",
      "title": "DocumentationSearch",
      "description": "Searches Apple Developer Documentation using semantic matching.",
      "inputSchema": {
        "properties": {
          "frameworks": {
            "type": "array",
            "description": "Framework(s) to search in. Searches all frameworks if not specified.",
            "items": {
              "type": "string"
            }
          },
          "query": {
            "type": "string",
            "description": "The search query"
          }
        },
        "required": [
          "query"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "documents": {
            "type": "array",
            "description": "The documents most relevant to the search query",
            "items": {
              "properties": {
                "contents": {
                  "type": "string",
                  "description": "The document contents"
                },
                "kind": {
                  "type": "string",
                  "description": "The kind of document"
                },
                "score": {
                  "type": "number",
                  "description": "The matching score of the document"
                },
                "title": {
                  "type": "string",
                  "description": "The document title"
                },
                "uri": {
                  "type": "string",
                  "description": "The document uri"
                }
              },
              "required": [
                "title",
                "uri",
                "contents",
                "score",
                "kind"
              ],
              "type": "object"
            }
          }
        },
        "required": [
          "documents"
        ],
        "type": "object"
      }
    },
    {
      "name": "GetBuildLog",
      "title": "Get Build Log",
      "description": "Gets the log of the current or most recently finished build. You can choose which build log entries to include by specifying the severity of any issues emitted by the build task represented by the entry. You can also filter by message regex pattern or file glob pattern. The response also indicates whether the build is currently in progress.",
      "inputSchema": {
        "properties": {
          "glob": {
            "type": "string",
            "description": "Glob to filter the returned build log entries. Will match against the 'path' field of any emitted issues, as well as against the location of any build task."
          },
          "pattern": {
            "type": "string",
            "description": "Regex to filter the returned build log entries. Will match against the 'message' field of any emitted issues, as well as the task description, command line, and console output of any build tasks."
          },
          "severity": {
            "type": "string",
            "description": "Limit the output of build log entries to those that emitted issues of the specified severity or higher. Valid values in order of decreasing severity are 'error', 'warning', 'remark'. Defaults to 'error'.",
            "enum": [
              "remark",
              "warning",
              "error"
            ]
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          }
        },
        "required": [
          "tabIdentifier"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "buildIsRunning": {
            "type": "boolean",
            "description": "Indicates whether the build is still running."
          },
          "buildLogEntries": {
            "type": "array",
            "description": "The build log entries describing build commands that emitted issues",
            "items": {
              "properties": {
                "buildTask": {
                  "type": "string",
                  "description": "The build task represented by the log entry"
                },
                "emittedIssues": {
                  "type": "array",
                  "description": "Any issues emitted by the build task represented by the log entry",
                  "items": {
                    "properties": {
                      "line": {
                        "type": "integer",
                        "description": "The line number where the issue was detected, if known"
                      },
                      "message": {
                        "type": "string",
                        "description": "The message describing the issue"
                      },
                      "path": {
                        "type": "string",
                        "description": "The file path where the issue was detected, if any"
                      },
                      "severity": {
                        "type": "string",
                        "description": "The severity of issue (error, warning, remark)"
                      }
                    },
                    "required": [
                      "line",
                      "severity",
                      "message"
                    ],
                    "type": "object"
                  }
                }
              },
              "required": [
                "emittedIssues"
              ],
              "type": "object"
            }
          },
          "buildResult": {
            "type": "string",
            "description": "The message indicating the result of the build operation"
          },
          "fullLogPath": {
            "type": "string",
            "description": "Path of the full log in textual format, containing the complete command lines and any output from the build tasks"
          },
          "message": {
            "type": "string",
            "description": "Optional message with additional information about the search results"
          },
          "totalFound": {
            "type": "integer",
            "description": "Total number of build log entries before truncation"
          },
          "truncated": {
            "type": "boolean",
            "description": "Whether results were truncated due to exceeding 100 issues"
          }
        },
        "required": [
          "buildResult",
          "buildLogEntries",
          "buildIsRunning",
          "truncated",
          "totalFound",
          "fullLogPath"
        ],
        "type": "object"
      }
    },
    {
      "name": "GetConsoleOutput",
      "title": "GetConsoleOutput",
      "description": "Retrieves console output (stdout, stderr, OSLog) from a running or completed app launch session. Supports regex filtering, severity filtering, and context extraction. Use this to analyze app logs, debug issues, find errors, or understand app behavior.",
      "inputSchema": {
        "properties": {
          "contextLines": {
            "type": "integer",
            "description": "Number of context lines to include around pattern matches (like grep -C). Use this with 'pattern' to see surrounding context. Default: 0"
          },
          "includeMetadata": {
            "type": "boolean",
            "description": "Include detailed OSLog metadata (subsystem, category, pid, tid, sender info). Only applies to OSLog items. Default: false"
          },
          "launchSessionReference": {
            "type": "string",
            "description": "Optional launch session reference. Omit to use the current/most recent launch session."
          },
          "oslogSeverity": {
            "type": "array",
            "description": "Filter OSLog by severity levels. Array of: 'error', 'fault', 'info', 'debug', 'default'. Only filters OSLog items, not stdout/stderr. Omit to include all severities.",
            "items": {
              "type": "string"
            }
          },
          "outputType": {
            "type": "string",
            "description": "Type of output to retrieve: 'stdio' (stdout/stderr only), 'oslog' (OSLog only), or 'all' (both). Default: 'all'",
            "enum": [
              "stdio",
              "oslog",
              "all"
            ]
          },
          "pattern": {
            "type": "string",
            "description": "Optional regex pattern to filter console output. Uses full regex syntax (e.g., 'error.*failed', 'Exception.*\\n.*at line'). Filters both stdout/stderr text and OSLog message content."
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          },
          "tailLimit": {
            "type": "integer",
            "description": "Maximum number of lines to return from the END of output (tail behavior). Returns the last N lines. Default: 500."
          }
        },
        "required": [
          "tabIdentifier"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "launchSessionInfo": {
            "type": "string",
            "description": "Information about the launch session: app name, reference, PID, and state (running/expired/etc). Useful for verifying which session was queried."
          },
          "totalCount": {
            "type": "integer",
            "description": "Total line count before limits applied. Use this to understand how much output was available."
          },
          "truncated": {
            "type": "boolean",
            "description": "True if results were truncated due to tailLimit."
          },
          "units": {
            "type": "array",
            "description": "Array of console output units. Each unit is a message/log entry with content, timestamp, kind (stdio/oslog), and optional severity.",
            "items": {
              "properties": {
                "content": {
                  "type": "string",
                  "description": "The console output text. For stdio: raw stdout/stderr text. For OSLog: the log message (without metadata unless includeMetadata=true, then this is the parsed message)."
                },
                "kind": {
                  "type": "string",
                  "description": "The type of console output: 'stdio' for stdout/stderr, 'oslog' for OSLog system logs"
                },
                "metadata": {
                  "properties": {
                    "category": {
                      "type": "string",
                      "description": "OSLog category within the subsystem (e.g., 'networking', 'database'). Used for finer-grained filtering."
                    },
                    "format": {
                      "type": "string",
                      "description": "OSLog format string with placeholders (e.g., 'Request failed: %{public}@')"
                    },
                    "library": {
                      "type": "string",
                      "description": "Library/framework that logged this message"
                    },
                    "messageType": {
                      "type": "string",
                      "description": "OSLog severity: 'default', 'info', 'debug', 'error', or 'fault'"
                    },
                    "pid": {
                      "type": "integer",
                      "description": "Process ID that generated this log"
                    },
                    "processName": {
                      "type": "string",
                      "description": "Name of the process that generated this log"
                    },
                    "senderFunctionName": {
                      "type": "string",
                      "description": "Function/method name that called the logging API (e.g., '-[UIViewController viewDidLoad]'). Useful for code location."
                    },
                    "senderImagePath": {
                      "type": "string",
                      "description": "Path to the executable/library that sent this log (e.g., '/System/Library/Frameworks/UIKit.framework/UIKit')"
                    },
                    "senderImageUUID": {
                      "type": "string",
                      "description": "UUID of the sender's binary image. Used for symbolication and crash analysis."
                    },
                    "senderSourceLine": {
                      "type": "integer",
                      "description": "Line number in source file where log was called (if available)"
                    },
                    "senderSourcePath": {
                      "type": "string",
                      "description": "Source file path where log was called (if available)"
                    },
                    "sessionUUID": {
                      "type": "string",
                      "description": "Unique identifier for the logging session"
                    },
                    "subsystem": {
                      "type": "string",
                      "description": "OSLog subsystem identifier (e.g., 'com.apple.UIKit'). Used for grouping related logs."
                    },
                    "tid": {
                      "type": "integer",
                      "description": "Thread ID that generated this log. Useful for identifying multi-threading issues."
                    },
                    "timestamp": {
                      "type": "string",
                      "description": "Formatted timestamp string from OSLog"
                    }
                  },
                  "required": [
                    "pid",
                    "tid"
                  ],
                  "type": "object",
                  "description": "Detailed OSLog metadata when includeMetadata=true. Includes: subsystem, category, pid, tid, process name, sender function/file/line, and more. Only present for kind='oslog' and when requested."
                },
                "severity": {
                  "type": "string",
                  "description": "OSLog severity level: 'error', 'fault', 'info', 'debug', or 'default'. Only present for kind='oslog'. Errors and faults indicate problems."
                },
                "timestamp": {
                  "type": "number",
                  "description": "Unix timestamp (seconds since epoch) of when this message appeared. Use this for chronological ordering and time-based analysis."
                }
              },
              "required": [
                "content",
                "kind",
                "timestamp"
              ],
              "type": "object"
            }
          }
        },
        "required": [
          "units",
          "totalCount",
          "truncated",
          "launchSessionInfo"
        ],
        "type": "object"
      }
    },
    {
      "name": "GetCrashIssueLogs",
      "title": "Get Crash Issue Logs",
      "description": "    Get detailed crash logs, expert triage knowledge, and actionable recommendations for a specific crash signature.\n    Use this after GetTopCrashIssues to drill down into specific crash issues.\n    Returns raw crash log text along with domain-specific analysis guidance from expert triage documents.\n    If no `bundle_id` is provided, automatically resolves from the active scheme's target. `bundle_id` is case sensitive and capitalization matters.\n    If no `platform` is provided, automatically resolves from the app's supported platforms and the active run destination. Supported platform values: 'iOS', 'macOS', 'watchOS', 'tvOS', 'visionOS'.\n    Use `is_beta` to specify TestFlight (true) or App Store (false) data. If not provided, fetches data from both release channels.",
      "inputSchema": {
        "properties": {
          "app_version": {
            "type": "string",
            "description": "The app version to filter crash logs by (e.g., 4.6). If not provided, returns logs across all versions."
          },
          "bundle_id": {
            "type": "string",
            "description": "The bundle identifier of the app (e.g., com.apple.Playgrounds). If not provided, automatically resolved from the active scheme's target."
          },
          "is_beta": {
            "type": "boolean",
            "description": "Whether to fetch TestFlight (true) or App Store (false) data. If not provided, fetches data from both release channels."
          },
          "platform": {
            "type": "string",
            "description": "The platform to query (e.g., 'iOS', 'macOS', 'watchOS', 'tvOS', 'visionOS'). If not provided, automatically resolved from the active run destination."
          },
          "signature_name": {
            "type": "string",
            "description": "The human-readable crash signature name from GetTopCrashIssues"
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          }
        },
        "required": [
          "tabIdentifier",
          "signature_name"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "appVersion": {
            "type": "string",
            "description": "The app version that was queried (nil if all versions)"
          },
          "bundleId": {
            "type": "string",
            "description": "The bundle ID that was queried"
          },
          "data": {
            "type": "string",
            "description": "The crash logs and expert triage knowledge"
          },
          "message": {
            "type": "string",
            "description": "Status message about the operation"
          },
          "signatureName": {
            "type": "string",
            "description": "The crash signature name that was queried"
          },
          "success": {
            "type": "boolean",
            "description": "Whether the API request succeeded"
          }
        },
        "required": [
          "success",
          "data",
          "message",
          "bundleId",
          "signatureName"
        ],
        "type": "object"
      }
    },
    {
      "name": "GetFieldPerformanceIssueLogs",
      "title": "Get Field Performance Issue Logs",
      "description": "Get detailed logs, performance data, expert triage knowledge, and actionable recommendations for specific field performance issue.\nUse this after GetTopFieldPerformanceIssues to drill down into specific performance issues.\nThis tool provides detailed performance diagnostics including stack traces, timeline data, and domain-specific analysis guidance from expert triage documents.\nSupported diagnostic types: `launches` (app launch performance), `hangs` (app hang issues), `diskwrites` (disk write performance), `energy` (CPU/energy usage).\nIf no `bundle_id` is provided, automatically resolves from the active scheme's target. `bundle_id` is case sensitive and capitalization matters.\nIf no `platform` is provided, automatically resolves from the app's supported platforms and the active run destination. Supported platform values depend on the diagnostic type (e.g., 'iOS', 'macOS', 'watchOS', 'tvOS', 'visionOS').\nSome diagnostic types (e.g., energy) support both App Store and TestFlight data. Use `is_beta` to specify which release channel to query. If not provided, auto-detected from the app version.",
      "inputSchema": {
        "properties": {
          "app_version": {
            "type": "string",
            "description": "The app version (e.g., 13.14.0)"
          },
          "bundle_id": {
            "type": "string",
            "description": "The bundle identifier of the app (e.g., com.toyopagroup.picaboo). If not provided, automatically resolved from the active scheme's target."
          },
          "diagnostic_type": {
            "type": "string",
            "description": "The type of performance diagnostic to retrieve. Supported values: 'launches', 'hangs', 'diskwrites', 'energy'"
          },
          "is_beta": {
            "type": "boolean",
            "description": "Whether to fetch TestFlight (true) or App Store (false) data. If not provided, auto-detected from the app version."
          },
          "platform": {
            "type": "string",
            "description": "The platform to query (e.g., 'iOS', 'macOS', 'watchOS', 'tvOS', 'visionOS'). Supported values depend on the diagnostic type. If not provided, automatically resolved from the active run destination."
          },
          "signature_name": {
            "type": "string",
            "description": "The human-readable signature name from GetTopFieldPerformanceIssues"
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          }
        },
        "required": [
          "tabIdentifier",
          "app_version",
          "signature_name",
          "diagnostic_type"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "appVersion": {
            "type": "string",
            "description": "The app version that was queried"
          },
          "bundleId": {
            "type": "string",
            "description": "The bundle ID that was queried"
          },
          "data": {
            "type": "string",
            "description": "The formatted JSON response from the field report API"
          },
          "diagnosticType": {
            "type": "string",
            "description": "The diagnostic type that was queried"
          },
          "message": {
            "type": "string",
            "description": "Status message about the operation"
          },
          "signatureName": {
            "type": "string",
            "description": "The signature name that was queried"
          },
          "success": {
            "type": "boolean",
            "description": "Whether the API request succeeded"
          }
        },
        "required": [
          "success",
          "data",
          "message",
          "bundleId",
          "appVersion",
          "signatureName",
          "diagnosticType"
        ],
        "type": "object"
      }
    },
    {
      "name": "GetFileCompilerFlags",
      "title": "GetFileCompilerFlags",
      "description": "Gets the additional per-file compiler flags for a single source file in a specific Xcode target — the same value shown in the Compiler Flags column of Target > Build Phases > Compile Sources. Returns an empty string when the file is a member of the target with no flags set. Use UpdateFileCompilerFlags to modify flags.\n\nNote: Per-file compiler flags are uncommon — most targets configure compilation through target build settings instead. Use this tool to inspect existing per-file flags (e.g. when checking why one file in a target compiles differently from its peers, such as adopting `-fbounds-safety` for a single file).\n\nNote about Swift: Values shown for `.swift` files may not actually affect builds because the unit of compilation for Swift is a module. Prefer OTHER_SWIFT_FLAGS at the target level.",
      "inputSchema": {
        "properties": {
          "filePath": {
            "type": "string",
            "description": "The path to the source file within the Xcode project organization (e.g., 'ProjectName/Sources/MyFile.swift'). An absolute or workspace-relative filesystem path is also accepted as a fallback."
          },
          "projectPath": {
            "type": "string",
            "description": "The project-organization path of the .xcodeproj that owns the target (e.g., 'MyApp/MyApp.xcodeproj'). Only needed when the same target name exists in multiple projects in the workspace; omit otherwise. An absolute or workspace-relative filesystem path is also accepted as a fallback."
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier."
          },
          "targetName": {
            "type": "string",
            "description": "The name of the Xcode target whose build phase contains the source file."
          }
        },
        "required": [
          "tabIdentifier",
          "targetName",
          "filePath"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "compilerFlags": {
            "type": "string",
            "description": "The additional compiler flags on the file, as a single space-separated string. Empty when the file is a member of the target with no per-file flags set."
          },
          "filePath": {
            "type": "string",
            "description": "The project-organization path of the file."
          },
          "guidance": {
            "type": "string",
            "description": "Populated when a filesystem path was supplied and resolved to a project-organization path. Contains instructions for the agent to prefer the resolved path in subsequent calls."
          },
          "targetName": {
            "type": "string",
            "description": "The target whose per-file compiler flags were returned."
          },
          "warning": {
            "type": "string",
            "description": "Populated when the build system is unlikely to honor per-file flags on this file (e.g. Swift sources, where the unit of compilation is a module). The flags returned are still the values stored in the project, but the agent should not assume they influence the build; consider a target-level setting instead."
          }
        },
        "required": [
          "targetName",
          "filePath",
          "compilerFlags"
        ],
        "type": "object"
      }
    },
    {
      "name": "GetTargetBuildSettings",
      "title": "GetTargetBuildSettings",
      "description": "Get all the Xcode build setting for a specified Xcode project target.\nAlways use this tool to get the build settings for a target.\nOnly show the target value for each build setting if the user explicitly requests.\n\nIMPORTANT: Do NOT try to parse the project.pbxproj file directly.\"",
      "inputSchema": {
        "properties": {
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier."
          },
          "targetName": {
            "type": "string",
            "description": "The name of a given Xcode project target."
          }
        },
        "required": [
          "tabIdentifier",
          "targetName"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "buildSettings": {
            "type": "array",
            "description": "An array of build settings for the named target.",
            "items": {
              "type": "object"
            }
          },
          "targetName": {
            "type": "string",
            "description": "The real name of a Xcode project target, also known as a blueprint."
          }
        },
        "required": [
          "targetName",
          "buildSettings"
        ],
        "type": "object"
      }
    },
    {
      "name": "GetTestList",
      "title": "Get Test List",
      "description": "Gets all available tests from the active scheme's active test plan. Results are limited to 100 tests. The complete list is written to fullTestListPath in grep-friendly format. Use grep with keys like TEST_TARGET, TEST_IDENTIFIER, or TEST_FILE_PATH to find specific tests.",
      "inputSchema": {
        "properties": {
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          }
        },
        "required": [
          "tabIdentifier"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "activeTestPlanName": {
            "type": "string",
            "description": "The active test plan name"
          },
          "counts": {
            "properties": {
              "disabled": {
                "type": "integer",
                "description": "Number of disabled tests"
              },
              "enabled": {
                "type": "integer",
                "description": "Number of enabled tests"
              },
              "total": {
                "type": "integer",
                "description": "Total test count"
              }
            },
            "required": [
              "total",
              "enabled",
              "disabled"
            ],
            "type": "object",
            "description": "Aggregated test counts"
          },
          "fullTestListPath": {
            "type": "string",
            "description": "Path to file containing complete test list"
          },
          "schemeName": {
            "type": "string",
            "description": "The active scheme name"
          },
          "summary": {
            "type": "string",
            "description": "Human-readable test list summary"
          },
          "tests": {
            "type": "array",
            "description": "List of tests limited to 100",
            "items": {
              "properties": {
                "displayName": {
                  "type": "string",
                  "description": "Human readable test name"
                },
                "filePath": {
                  "type": "string",
                  "description": "Source file path"
                },
                "identifier": {
                  "type": "string",
                  "description": "Test identifier in XCTestIdentifier format"
                },
                "isEnabled": {
                  "type": "boolean",
                  "description": "Whether the test is enabled in the test plan"
                },
                "lineNumber": {
                  "type": "integer",
                  "description": "Line number in source file"
                },
                "tags": {
                  "type": "array",
                  "description": "Swift Testing tags",
                  "items": {
                    "type": "string"
                  }
                },
                "targetName": {
                  "type": "string",
                  "description": "The test target name"
                }
              },
              "required": [
                "targetName",
                "identifier",
                "displayName",
                "isEnabled"
              ],
              "type": "object"
            }
          },
          "totalTests": {
            "type": "integer",
            "description": "Total number of tests before truncation"
          },
          "truncated": {
            "type": "boolean",
            "description": "Whether test list was truncated"
          }
        },
        "required": [
          "tests",
          "schemeName",
          "summary",
          "counts",
          "truncated",
          "totalTests",
          "fullTestListPath"
        ],
        "type": "object"
      }
    },
    {
      "name": "GetTopCrashIssues",
      "title": "Get Top Crash Issues",
      "description": "    Retrieve the top crash signatures for an app from Apple's crash reporting service.\n    Returns crash signatures sorted by device count (number of unique devices affected) for the last 14 days.\n    Use this tool to identify and prioritize the most impactful crashes in your app.\n    If no `bundle_id` is provided, automatically resolves from the active scheme's target. `bundle_id` is case sensitive and capitalization matters.\n    If no `platform` is provided, automatically resolves from the app's supported platforms and the active run destination. Supported platform values: 'iOS', 'macOS', 'watchOS', 'tvOS', 'visionOS'.\n    If no `app_version` is provided, returns crashes across all versions. If provided, filters to that specific version.\n    Use `is_beta` to specify TestFlight (true) or App Store (false) data. If not provided, returns data from both release channels.",
      "inputSchema": {
        "properties": {
          "app_version": {
            "type": "string",
            "description": "The app version to filter by (e.g., 4.6). If not provided, returns crashes across all versions for the last 14 days."
          },
          "bundle_id": {
            "type": "string",
            "description": "The bundle identifier of the app (e.g., com.apple.Playgrounds). If not provided, automatically resolved from the active scheme's target."
          },
          "count": {
            "type": "integer",
            "description": "Number of top crash signatures to return. Use 1 when the user asks for their 'top crash' (singular). Defaults to 5 when not specified or when the user asks for 'top crashes' (plural)."
          },
          "is_beta": {
            "type": "boolean",
            "description": "Whether to fetch TestFlight (true) or App Store (false) data. If not provided, returns data from both release channels."
          },
          "platform": {
            "type": "string",
            "description": "The platform to query (e.g., 'iOS', 'macOS', 'watchOS', 'tvOS', 'visionOS'). If not provided, automatically resolved from the active run destination."
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          }
        },
        "required": [
          "tabIdentifier"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "appVersion": {
            "type": "string",
            "description": "The app version that was queried (nil if all versions)"
          },
          "bundleId": {
            "type": "string",
            "description": "The bundle ID that was queried"
          },
          "data": {
            "type": "string",
            "description": "The formatted JSON response with top crash signatures"
          },
          "message": {
            "type": "string",
            "description": "Status message about the operation"
          },
          "success": {
            "type": "boolean",
            "description": "Whether the API request succeeded"
          }
        },
        "required": [
          "success",
          "data",
          "message",
          "bundleId"
        ],
        "type": "object"
      }
    },
    {
      "name": "GetTopFieldPerformanceIssues",
      "title": "Get Top Field Performance Issues",
      "description": "    Analyze app performance and identify performance regressions across different diagnostic types.\n    Use this tool to investigate or analyze performance issues by querying Apple's field report APIs.\n    Supported diagnostic types: `launches` (app launch performance), `hangs` (app hang issues), `diskwrites` (disk write performance), `energy` (CPU/energy usage).\n    If no `bundle_id` is provided, automatically resolves from the active scheme's target. `bundle_id` is case sensitive and capitalization matters.\n    If no `platform` is provided, automatically resolves from the app's supported platforms and the active run destination. Supported platform values depend on the diagnostic type (e.g., 'iOS', 'macOS', 'watchOS', 'tvOS', 'visionOS').\n    Some diagnostic types (e.g., energy) support both App Store and TestFlight data. Use `is_beta` to specify which release channel to query. If not provided, auto-detected from the app version when possible.",
      "inputSchema": {
        "properties": {
          "app_version": {
            "type": "string",
            "description": "The app version (e.g., 4.6). If not provided, returns a list of available versions to choose from."
          },
          "bundle_id": {
            "type": "string",
            "description": "The bundle identifier of the app (e.g., com.apple.Playgrounds). If not provided, automatically resolved from the active scheme's target."
          },
          "diagnostic_type": {
            "type": "string",
            "description": "The type of performance diagnostic to retrieve. Supported values: 'launches', 'hangs', 'diskwrites', 'energy'"
          },
          "is_beta": {
            "type": "boolean",
            "description": "Whether to fetch TestFlight (true) or App Store (false) data. If not provided, auto-detected from the app version when possible. For diagnostic types that support both (e.g., energy), you will be asked to choose if it cannot be determined."
          },
          "platform": {
            "type": "string",
            "description": "The platform to query (e.g., 'iOS', 'macOS', 'watchOS', 'tvOS', 'visionOS'). Supported values depend on the diagnostic type. If not provided, automatically resolved from the active run destination."
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          }
        },
        "required": [
          "tabIdentifier",
          "diagnostic_type"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "appVersion": {
            "type": "string",
            "description": "The app version that was queried (nil if version selection is needed)"
          },
          "availableVersions": {
            "type": "array",
            "description": "List of available versions when app_version was not provided. Each entry has 'version' and 'build' keys.",
            "items": {
              "type": "object"
            }
          },
          "bundleId": {
            "type": "string",
            "description": "The bundle ID that was queried"
          },
          "data": {
            "type": "string",
            "description": "The formatted JSON response from the field report API"
          },
          "diagnosticType": {
            "type": "string",
            "description": "The diagnostic type that was queried"
          },
          "message": {
            "type": "string",
            "description": "Status message about the operation"
          },
          "success": {
            "type": "boolean",
            "description": "Whether the API request succeeded"
          }
        },
        "required": [
          "success",
          "data",
          "message",
          "bundleId",
          "diagnosticType"
        ],
        "type": "object"
      }
    },
    {
      "name": "InvokeDebuggerCommand",
      "title": "Invoke a Debugger Command",
      "description": "Sends an lldb command to Xcode's active debugging session and returns the output.\nThe process must already be running with the debugger attached. You can use the\nRunProject tool with attachDebugger=true, if it isn't running and debugged already.\n\nSend any lldb command: 'bt', 'po variable', 'breakpoint set -n main', 'continue',\n'thread step-over', 'frame variable', etc. The command runs in the same lldb session\nas Xcode's debug console, so the agent and Xcode UI share the same debugging state.",
      "inputSchema": {
        "properties": {
          "command": {
            "type": "string",
            "description": "The lldb command to execute in Xcode's active debug session (e.g., 'bt', 'po self', 'breakpoint set -n viewDidLoad', 'continue', 'thread step-over', 'frame variable')."
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          },
          "timeout": {
            "type": "integer",
            "description": "Maximum seconds to wait for the command to complete. Default: 30. Increase for commands that resume execution (e.g., 'continue')."
          }
        },
        "required": [
          "tabIdentifier",
          "command"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "debugSessionActive": {
            "type": "boolean",
            "description": "Whether an active debug session exists. False if no app is being debugged."
          },
          "isWaitingForMore": {
            "type": "boolean",
            "description": "True if the command timed out before completing. The command may still be executing (e.g., after 'continue'). Call again with a simple command like 'thread list' to check the state."
          },
          "output": {
            "type": "string",
            "description": "The lldb output from the command. This is the same output that appears in Xcode's debug console."
          },
          "processIdentifier": {
            "type": "integer",
            "description": "The process identifier (PID) of the debugged process, if available."
          }
        },
        "required": [
          "output",
          "debugSessionActive",
          "isWaitingForMore"
        ],
        "type": "object"
      }
    },
    {
      "name": "LocalizationPlanner",
      "title": "Prepare For Localization",
      "description": "Ensures the project is in a state where translations can be added. **Call this tool each time you are tasked with adding a language** to the project, or to translate an entire project. Before calling this tool, you MUST activate the `xcode-integration:translation-coordinator` skill. Do not call this tool without first loading that skill's instructions.",
      "inputSchema": {
        "properties": {
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          },
          "targetLocaleIdentifier": {
            "type": "string",
            "description": "The locale identifier for which you want to translate"
          }
        },
        "required": [
          "tabIdentifier",
          "targetLocaleIdentifier"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "changesMade": {
            "type": "string",
            "description": "List of changes successfully made to the project. Includes list of all String Catalogs in the project."
          },
          "nextStep": {
            "type": "string",
            "description": "Advisory telling you what action to take next. Follow these steps to successfully localize the entire project."
          },
          "stepsFailed": {
            "type": "string",
            "description": "Description of failed steps that require manual intervention. The user has to execute them manually. If nil, all steps succeeded."
          },
          "suggestions": {
            "type": "string",
            "description": "Non-blocking suggestions for improving the project's localization setup. The user should consider these recommendations. Don't try to follow them yourself, it needs a user interaction."
          }
        },
        "required": [
          "nextStep"
        ],
        "type": "object"
      }
    },
    {
      "name": "RenderPreview",
      "title": "RenderPreview",
      "description": "Builds and renders a Preview and waits until a snapshot of the resulting UI is available.",
      "inputSchema": {
        "properties": {
          "previewCanvasControlOverrides": {
            "properties": {
              "timelineIndex": {
                "type": "integer",
                "description": "A zero-based timestop index to render for previews that vary across a timeline, such as a Widget or a Live Activity. This index represents a sequence number rather than a specific clock time. This parameter is only meaningful for previews that return a list of indexes in the `timelineIndexes` field of `supportedCanvasControlOverrides` of the same invocation of this tool for the same active scheme and run destination. If no index is provided, the first preview in the timeline is rendered. This parameter is ignored for previews that don't have a timeline. "
              },
              "toggleState": {
                "type": "boolean",
                "description": "The boolean state of a toggle control for previews that have one, such as a Live Activity. This parameter is only meaningful for previews that return a toggle state in the `toggleState` field of `supportedCanvasControlOverrides` of the same invocation of this tool for the same active scheme and run destination. If no state is provided, the first state in the toggle state list is rendered. This parameter is ignored for previews that don't have a toggle control."
              }
            },
            "required": [],
            "type": "object",
            "description": "Optional overrides for the canvas controls, only applicable to preview types that support each kind of canvas control. Use the `supportedCanvasControlOverrides` field of the output of a previous invocation of this tool to get the available canvas control overrides and their supported values."
          },
          "previewDefinitionIndexInFile": {
            "type": "integer",
            "description": "The zero based index of the #Preview macro or PreviewProvider struct definition in the source file counting from the top. Defaults to 0, i.e. the first one."
          },
          "previewLocalizationOverride": {
            "type": "string",
            "description": "A locale identifier to preview in (e.g. \"fr\", \"ja\"). Use a value that was returned in the `supportedLocalizations` field by a previous invocation of this tool."
          },
          "previewVariantOverrides": {
            "type": "object",
            "description": "A dictionary mapping variant group names to variant names for any preview variants that should be overridden. Use keys and values that were returned in the `supportedPreviewVariantOverrides` field by a previous invocation of this tool for the same active scheme and run destination."
          },
          "sourceFilePath": {
            "type": "string",
            "description": "The path to the file within the Xcode project organization (e.g., 'ProjectName/Sources/MyFile.swift')"
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          },
          "timeout": {
            "type": "integer",
            "description": "The time in seconds to wait for the rendering of the preview to complete. Defaults to 120 seconds."
          }
        },
        "required": [
          "tabIdentifier",
          "sourceFilePath"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "errors": {
            "type": "array",
            "description": "Any errors that occurred during the preview attempt (such as input validation failures).",
            "items": {
              "properties": {
                "message": {
                  "type": "string",
                  "description": "The error message with potential underlying errors included."
                }
              },
              "required": [
                "message"
              ],
              "type": "object"
            }
          },
          "previewSnapshotPath": {
            "type": "string",
            "description": "The path to the image snapshot of the requested preview."
          },
          "supportedCanvasControlOverrides": {
            "properties": {
              "timelineIndexes": {
                "type": "array",
                "description": "List of supported timeline indexes for previews that vary across a timeline, such as Widgets or Live Activities. The indexes represents sequence numbers rather than specific times. Omitted if the preview doesn't have a timeline control.",
                "items": {
                  "type": "integer"
                }
              },
              "toggleStates": {
                "type": "array",
                "description": "List of supported toggle states, for previews that have toggle control. Omitted if the preview doesn't have a toggle control.",
                "items": {
                  "type": "boolean"
                }
              }
            },
            "required": [],
            "type": "object",
            "description": "The supported canvas control overrides for this preview, which can be passed to the tool in the `previewCanvasControlOverrides` parameter in subsequent tool invocations. Contains `timelineIndexes` for previews that vary across a timeline (such as Widgets or Live Activities) and `toggleStates` for previews that have a toggle control. Omitted if the preview doesn't support any canvas control overrides."
          },
          "supportedLocalizations": {
            "type": "array",
            "description": "The locale identifiers supported by the workspace (e.g. [\"en\", \"fr\", \"ja\"]), which can be passed to the tool in the `previewLocalizationOverride` parameter in subsequent tool invocations to preview in a specific language. Do not call this tool in parallel with other invocations when this parameter is provided.",
            "items": {
              "type": "string"
            }
          },
          "supportedPreviewVariantOverrides": {
            "type": "object",
            "description": "The supported preview variant overrides, which can be passed to the tool in the `previewVariantOverrides` parameter in subsequent tool invocations. The keys are the names of variant groups that can be overridden, and the values are the names of the variants that are supported for that group."
          }
        },
        "required": [],
        "type": "object"
      }
    },
    {
      "name": "RunAllTests",
      "title": "Run All Tests",
      "description": "Runs all tests from the active scheme's active test plan",
      "inputSchema": {
        "properties": {
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          }
        },
        "required": [
          "tabIdentifier"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "activeTestPlanName": {
            "type": "string",
            "description": "Active test plan name"
          },
          "counts": {
            "properties": {
              "expectedFailures": {
                "type": "integer",
                "description": "Number of expected failures"
              },
              "failed": {
                "type": "integer",
                "description": "Number of failed tests"
              },
              "notRun": {
                "type": "integer",
                "description": "Number of tests not run"
              },
              "passed": {
                "type": "integer",
                "description": "Number of passed tests"
              },
              "skipped": {
                "type": "integer",
                "description": "Number of skipped tests"
              },
              "total": {
                "type": "integer",
                "description": "Total test count"
              }
            },
            "required": [
              "total",
              "passed",
              "failed",
              "skipped",
              "expectedFailures",
              "notRun"
            ],
            "type": "object",
            "description": "Test execution counts"
          },
          "fullConsoleLogsPath": {
            "type": "string",
            "description": "A text file path containing all logs that would be printed in the console from `print`, `NSLog`, etc. during test build and execution."
          },
          "fullSummaryPath": {
            "type": "string",
            "description": "A text file path containing all test results and complete issue details in textual form"
          },
          "message": {
            "type": "string",
            "description": "Additional information about truncation"
          },
          "results": {
            "type": "array",
            "description": "Results for each test (truncated at 100, failures shown first)",
            "items": {
              "properties": {
                "displayName": {
                  "type": "string",
                  "description": "Human-readable test name"
                },
                "errorMessages": {
                  "type": "array",
                  "description": "Error messages",
                  "items": {
                    "type": "string"
                  }
                },
                "identifier": {
                  "type": "string",
                  "description": "Test identifier in XCTestIdentifier format"
                },
                "state": {
                  "type": "string",
                  "description": "Execution state"
                },
                "targetName": {
                  "type": "string",
                  "description": "The test target name"
                }
              },
              "required": [
                "targetName",
                "identifier",
                "displayName",
                "state",
                "errorMessages"
              ],
              "type": "object"
            }
          },
          "schemeName": {
            "type": "string",
            "description": "Active scheme name"
          },
          "summary": {
            "type": "string",
            "description": "Test execution summary"
          },
          "totalResults": {
            "type": "integer",
            "description": "Total number of test results before truncation"
          },
          "truncated": {
            "type": "boolean",
            "description": "Whether results were truncated due to exceeding 100 results"
          },
          "xcresultBundlePath": {
            "type": "string",
            "description": "Path to the .xcresult bundle produced by the test run. Can be parsed with xcresulttool. If code coverage is enabled, xccov can extract coverage data from this bundle."
          }
        },
        "required": [
          "summary",
          "counts",
          "results",
          "schemeName",
          "truncated",
          "totalResults",
          "fullSummaryPath"
        ],
        "type": "object"
      }
    },
    {
      "name": "RunCodeSnippet",
      "title": "RunCodeSnippet",
      "description": "Builds and runs a snippet of code in the context of a specific file and waits until results are available. This tool is available for source files in targets that build applications, frameworks, libraries, or command line executables. The output consists of the console output generated by the `print` statements contained in the provided snippet.",
      "inputSchema": {
        "properties": {
          "codeSnippet": {
            "type": "string",
            "description": "The code snippet that should be run within the context of the specified Swift file."
          },
          "purpose": {
            "type": "string",
            "description": "A short human-readable description of the purpose of running this code snippet. Do NOT use the word 'test' in this string, because that is misleading and could make the user think that this functionality is related to testing."
          },
          "sourceFilePath": {
            "type": "string",
            "description": "The path to a Swift source file within the Xcode project organization (e.g., 'ProjectName/Sources/MyFile.swift') whose context the code snippet will have access to (including `fileprivate` declarations)."
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier."
          },
          "timeout": {
            "type": "integer",
            "description": "The time in seconds to wait for the running of the snippet to complete. Defaults to 600 seconds."
          }
        },
        "required": [
          "tabIdentifier",
          "codeSnippet",
          "sourceFilePath",
          "purpose"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "error": {
            "properties": {
              "detailsPath": {
                "type": "string",
                "description": "The path of an optional file that contains all the details of the error."
              },
              "message": {
                "type": "string",
                "description": "A very short message describing the error."
              },
              "recoveryAdvice": {
                "type": "string",
                "description": "An optional message providing advice on how to resolve the error."
              },
              "summary": {
                "type": "string",
                "description": "A longer summary of the error and (if known) its cause."
              }
            },
            "required": [
              "message",
              "summary"
            ],
            "type": "object",
            "description": "Any error that occurred while trying to run the snippet, if applicable. This could be a problem compiling the snippet or it could be a runtime error."
          },
          "executionResults": {
            "type": "string",
            "description": "The console output generated by the `print` statements contained in the provided snippet."
          }
        },
        "required": [],
        "type": "object"
      }
    },
    {
      "name": "RunProject",
      "title": "Run Project",
      "description": "Builds and runs the current scheme in Xcode, equivalent to pressing the Run button (Cmd+R).\nReturns when the app has launched and is running.\nUse the InvokeDebuggerCommand tool to debug the app (make sure to run with attachDebugger=true).\nUse the GetConsoleOutput tool to read the app's console output.\nUse the StopProject tool to stop the app, when finished.",
      "inputSchema": {
        "properties": {
          "attachDebugger": {
            "type": "boolean",
            "description": "Whether to attach the debugger to the launched process. Defaults to false."
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          }
        },
        "required": [
          "tabIdentifier"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "buildErrors": {
            "type": "array",
            "description": "List of build errors, if the build failed",
            "items": {
              "properties": {
                "classification": {
                  "type": "string",
                  "description": "The type of error (error, warning, etc.)"
                },
                "filePath": {
                  "type": "string",
                  "description": "The file path where the error occurred"
                },
                "lineNumber": {
                  "type": "integer",
                  "description": "The line number where the error occurred"
                },
                "message": {
                  "type": "string",
                  "description": "The error message"
                }
              },
              "required": [
                "classification",
                "message"
              ],
              "type": "object"
            }
          },
          "elapsedTime": {
            "type": "number",
            "description": "The time it took to build and launch, in seconds"
          },
          "fullLogPath": {
            "type": "string",
            "description": "Path of the full build log in textual format"
          },
          "launchSessionReference": {
            "type": "string",
            "description": "A reference to the launch session that can be passed to GetConsoleOutput to read the app's output"
          },
          "processIdentifier": {
            "type": "integer",
            "description": "The process identifier (PID) of the launched app"
          },
          "runResult": {
            "type": "string",
            "description": "The message indicating the result of the run operation"
          }
        },
        "required": [
          "runResult",
          "buildErrors",
          "fullLogPath"
        ],
        "type": "object"
      }
    },
    {
      "name": "RunSomeTests",
      "title": "Run Some Tests",
      "description": "Runs specific tests using the active scheme's active test plan",
      "inputSchema": {
        "properties": {
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          },
          "tests": {
            "type": "array",
            "description": "Array of test specifiers to run. Each specifier contains 'targetName' and 'testIdentifier' fields. Use GetTestList action to discover available tests and their identifiers, then extract the 'targetName' and 'identifier' fields from the TestActionInfo results to construct TestActionSpecifier objects.",
            "items": {
              "properties": {
                "targetName": {
                  "type": "string",
                  "description": "The test target name"
                },
                "testIdentifier": {
                  "type": "string",
                  "description": "Test identifier in XCTestIdentifier format"
                }
              },
              "required": [
                "targetName",
                "testIdentifier"
              ],
              "type": "object"
            }
          }
        },
        "required": [
          "tabIdentifier",
          "tests"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "activeTestPlanName": {
            "type": "string",
            "description": "Active test plan name"
          },
          "counts": {
            "properties": {
              "expectedFailures": {
                "type": "integer",
                "description": "Number of expected failures"
              },
              "failed": {
                "type": "integer",
                "description": "Number of failed tests"
              },
              "notRun": {
                "type": "integer",
                "description": "Number of tests not run"
              },
              "passed": {
                "type": "integer",
                "description": "Number of passed tests"
              },
              "skipped": {
                "type": "integer",
                "description": "Number of skipped tests"
              },
              "total": {
                "type": "integer",
                "description": "Total test count"
              }
            },
            "required": [
              "total",
              "passed",
              "failed",
              "skipped",
              "expectedFailures",
              "notRun"
            ],
            "type": "object",
            "description": "Test execution counts"
          },
          "fullConsoleLogsPath": {
            "type": "string",
            "description": "A text file path containing all logs that would be printed in the console from `print`, `NSLog`, etc. during test build and execution."
          },
          "fullSummaryPath": {
            "type": "string",
            "description": "A text file path containing all test results and complete issue details in textual form"
          },
          "message": {
            "type": "string",
            "description": "Additional information about truncation"
          },
          "results": {
            "type": "array",
            "description": "Results for each test (truncated at 100, failures shown first)",
            "items": {
              "properties": {
                "displayName": {
                  "type": "string",
                  "description": "Human-readable test name"
                },
                "errorMessages": {
                  "type": "array",
                  "description": "Error messages",
                  "items": {
                    "type": "string"
                  }
                },
                "identifier": {
                  "type": "string",
                  "description": "Test identifier in XCTestIdentifier format"
                },
                "state": {
                  "type": "string",
                  "description": "Execution state"
                },
                "targetName": {
                  "type": "string",
                  "description": "The test target name"
                }
              },
              "required": [
                "targetName",
                "identifier",
                "displayName",
                "state",
                "errorMessages"
              ],
              "type": "object"
            }
          },
          "schemeName": {
            "type": "string",
            "description": "Active scheme name"
          },
          "summary": {
            "type": "string",
            "description": "Test execution summary"
          },
          "totalResults": {
            "type": "integer",
            "description": "Total number of test results before truncation"
          },
          "truncated": {
            "type": "boolean",
            "description": "Whether results were truncated due to exceeding 100 results"
          },
          "xcresultBundlePath": {
            "type": "string",
            "description": "Path to the .xcresult bundle produced by the test run. Can be parsed with xcresulttool. If code coverage is enabled, xccov can extract coverage data from this bundle."
          }
        },
        "required": [
          "summary",
          "counts",
          "results",
          "schemeName",
          "truncated",
          "totalResults",
          "fullSummaryPath"
        ],
        "type": "object"
      }
    },
    {
      "name": "StopProject",
      "title": "Stop Project",
      "description": "Stops the currently running app in Xcode, equivalent to pressing the Stop button (Cmd+.).\nIf no app is currently running, reports that there is nothing to stop.",
      "inputSchema": {
        "properties": {
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          }
        },
        "required": [
          "tabIdentifier"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "processIdentifier": {
            "type": "integer",
            "description": "The process identifier (PID) of the app that was stopped"
          },
          "stopResult": {
            "type": "string",
            "description": "The result of the stop operation"
          }
        },
        "required": [
          "stopResult"
        ],
        "type": "object"
      }
    },
    {
      "name": "StringCatalogContext",
      "title": "Get String Context",
      "description": "Returns context and the source language value for a given string in the String Catalog. The sourceValues field contains the text that must be translated. Before calling this tool, you MUST activate the `xcode-integration:translation` skill. Do not call this tool without first loading that skill's instructions.",
      "inputSchema": {
        "properties": {
          "filePath": {
            "type": "string",
            "description": "The path to the String Catalog"
          },
          "stringKey": {
            "type": "string",
            "description": "String key for which to get context for"
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          },
          "targetLocaleIdentifier": {
            "type": "string",
            "description": "The locale identifier for which you want to translate"
          }
        },
        "required": [
          "tabIdentifier",
          "filePath",
          "stringKey",
          "targetLocaleIdentifier"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "appearances": {
            "type": "array",
            "description": "Hints about how this string is displayed in the UI. Includes element type (button, label) and framework (SwiftUI, UIKit, AppKit). Null if appearance data unavailable.",
            "items": {
              "type": "object"
            }
          },
          "comment": {
            "type": "string",
            "description": "Comment from the String Catalog, if present"
          },
          "isStringSet": {
            "type": "boolean",
            "description": "Whether the string is a string set (array of values). Only set for string sets."
          },
          "nextSteps": {
            "type": "string",
            "description": "Suggestions of what tool to use next"
          },
          "relevantPluralCases": {
            "type": "array",
            "description": "If the string contains numerical format specifiers, this lists the relevant plural cases for the target locale (e.g., ['zero', 'one', 'other']). When empty, this string doesn't require any pluralization.",
            "items": {
              "type": "string"
            }
          },
          "shouldTranslate": {
            "type": "boolean",
            "description": "Whether this string should be translated (false means 'DO NOT TRANSLATE')"
          },
          "similarStrings": {
            "type": "array",
            "description": "Similar strings found in other String Catalogs in the workspace, useful for understanding translation patterns. Keep your translation similar to these strings and learn terminology and formality used in this project.",
            "items": {
              "type": "object"
            }
          },
          "sourceValues": {
            "properties": {
              "setValues": {
                "type": "array",
                "description": "For string sets: the source language values. Each one must be translated. Only set for string sets",
                "items": {
                  "type": "string"
                }
              },
              "sourceLocaleIdentifier": {
                "type": "string",
                "description": "The source locale identifier."
              },
              "value": {
                "type": "string",
                "description": "The source language value that MUST be translated. This is the text to translate, NOT the key"
              },
              "variationDescription": {
                "type": "string",
                "description": "For varied strings: human-readable description of the source variation tree showing all variants that need translation"
              }
            },
            "required": [
              "sourceLocaleIdentifier"
            ],
            "type": "object",
            "description": "The source language values that you MUST translate into the target locale. Contains the text to translate — do NOT translate the key."
          },
          "supportedDevices": {
            "type": "array",
            "description": "The devices this String Catalog builds for (e.g., device.iphone, device.mac). Varying a string by device is optional and rarely needed. Only consider adding device variations when the string contains a reference to tapping or clicking, or when it mentions a specific device name like \"on your iPhone\". Most strings do not need device variations.",
            "items": {
              "type": "string"
            }
          },
          "translations": {
            "type": "array",
            "description": "Existing translations for this string in locales related to the target locale",
            "items": {
              "type": "object"
            }
          },
          "usageDataUnavailable": {
            "type": "string",
            "description": "Informational message when usage data cannot be retrieved. Contains guidance on how to proceed (e.g., build project). Null when usage data is successfully retrieved."
          },
          "usageLocations": {
            "type": "array",
            "description": "Locations in source code where this string is used, including file paths, line numbers, and column numbers. Use this information to __always__ check the code at these locations in the project to learn more about HOW the string is used in the codebase. This is a vital clue for a better understanding of the string's meaning.",
            "items": {
              "type": "object"
            }
          }
        },
        "required": [
          "sourceValues",
          "shouldTranslate",
          "relevantPluralCases",
          "translations",
          "usageLocations",
          "similarStrings",
          "nextSteps"
        ],
        "type": "object"
      }
    },
    {
      "name": "StringCatalogEdit",
      "title": "Insert Translation",
      "description": "Inserts a translation for a given locale into a String Catalog. Before calling this tool, you MUST activate the `xcode-integration:translation` skill. Do not call this tool without first loading that skill's instructions.",
      "inputSchema": {
        "properties": {
          "filePath": {
            "type": "string",
            "description": "The path to the String Catalog"
          },
          "stringKey": {
            "type": "string",
            "description": "String key to translate"
          },
          "stringSetTranslation": {
            "type": "array",
            "description": "Array of translated values for string sets. Prefer typographically correct quotes for the target language (e.g., „...“ for German, «...» for French). All curly quotes must be escaped (e.g., \\u201E...\\u201C for German „...“)",
            "items": {
              "type": "string"
            }
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          },
          "targetLocaleIdentifier": {
            "type": "string",
            "description": "Identifier of the locale for which to insert the given translation"
          },
          "templateTranslation": {
            "properties": {
              "substitutions": {
                "type": "array",
                "description": "Array of substitution definitions",
                "items": {
                  "properties": {
                    "argNum": {
                      "type": "integer",
                      "description": "Argument number corresponding to the format specifier position in the original string"
                    },
                    "formatSpecifier": {
                      "type": "string",
                      "description": "Format specifier type without %."
                    },
                    "name": {
                      "type": "string",
                      "description": "Name of the substitution placeholder"
                    },
                    "variants": {
                      "type": "object",
                      "description": "Dictionary mapping variation paths to translated values. Prefer typographically correct quotes for the target language (e.g., „...“ for German, «...» for French). All curly quotes must be escaped (e.g., \\u201E...\\u201C for German „...“)"
                    }
                  },
                  "required": [
                    "name",
                    "argNum",
                    "formatSpecifier",
                    "variants"
                  ],
                  "type": "object"
                }
              },
              "template": {
                "type": "string",
                "description": "Template string containing substitution references. Prefer typographically correct quotes for the target language (e.g., „...“ for German, «...» for French). All curly quotes must be escaped (e.g., \\u201E...\\u201C for German „...“)"
              }
            },
            "required": [
              "template",
              "substitutions"
            ],
            "type": "object",
            "description": "Translation with template + substitutions for varying a string by plural or for translating a string that is already varied by plural. Prefer typographically correct quotes for the target language (e.g., „...“ for German, «...» for French). All curly quotes must be escaped (e.g., \\u201E...\\u201C for German „...“)"
          },
          "translation": {
            "type": "string",
            "description": "Simple string translation for non-varied strings. Prefer typographically correct quotes for the target language (e.g., „...“ for German, «...» for French). All curly quotes must be escaped (e.g., \\u201E...\\u201C for German „...“). Refer to the `xcode-integration:translation` skill for details"
          },
          "variationTranslation": {
            "properties": {
              "substitutions": {
                "type": "array",
                "description": "Optional array of substitution definitions for templates that reference substitutions. Prefer typographically correct quotes for the target language (e.g., „...“ for German, «...» for French). All curly quotes must be escaped (e.g., \\u201E...\\u201C for German „...“)",
                "items": {
                  "properties": {
                    "argNum": {
                      "type": "integer",
                      "description": "Argument number corresponding to the format specifier position in the original string"
                    },
                    "formatSpecifier": {
                      "type": "string",
                      "description": "Format specifier type without %."
                    },
                    "name": {
                      "type": "string",
                      "description": "Name of the substitution placeholder"
                    },
                    "variants": {
                      "type": "object",
                      "description": "Dictionary mapping variation paths to translated values. Prefer typographically correct quotes for the target language (e.g., „...“ for German, «...» for French). All curly quotes must be escaped (e.g., \\u201E...\\u201C for German „...“)"
                    }
                  },
                  "required": [
                    "name",
                    "argNum",
                    "formatSpecifier",
                    "variants"
                  ],
                  "type": "object"
                }
              },
              "topLevelVariation": {
                "type": "object",
                "description": "Dictionary mapping variation paths to template strings or translations. Prefer typographically correct quotes for the target language (e.g., „...“ for German, «...» for French). All curly quotes must be escaped (e.g., \\u201E...\\u201C for German „...“)"
              }
            },
            "required": [
              "topLevelVariation"
            ],
            "type": "object",
            "description": "Variation structure for strings with top-level plural, device, or width variations. Prefer typographically correct quotes for the target language (e.g., „...“ for German, «...» for French). All curly quotes must be escaped (e.g., \\u201E...\\u201C for German „...“)"
          }
        },
        "required": [
          "tabIdentifier",
          "filePath",
          "stringKey",
          "targetLocaleIdentifier"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "message": {
            "type": "string",
            "description": "Success or error message"
          },
          "success": {
            "type": "boolean",
            "description": "Whether the translation was successfully inserted"
          }
        },
        "required": [
          "success",
          "message"
        ],
        "type": "object"
      }
    },
    {
      "name": "StringCatalogRead",
      "title": "Read String Catalog",
      "description": "Returns string keys grouped by translation state for the requested locale. Before calling this tool, you MUST activate the `xcode-integration:translation-coordinator` skill. Do not call this tool without first loading that skill's instructions.",
      "inputSchema": {
        "properties": {
          "filePath": {
            "type": "string",
            "description": "The path to the String Catalog"
          },
          "keyLimit": {
            "type": "integer",
            "description": "Maximum number of keys to return"
          },
          "offset": {
            "type": "integer",
            "description": "Number of keys to skip before returning results"
          },
          "requestedState": {
            "type": "string",
            "description": "The translation state to retrieve keys for"
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          },
          "targetLocaleIdentifier": {
            "type": "string",
            "description": "Locale identifier to check translations for"
          }
        },
        "required": [
          "tabIdentifier",
          "filePath",
          "targetLocaleIdentifier"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "keys": {
            "type": "array",
            "description": "Array of string keys in the requested state. Curly apostrophes and quotes are escaped (e.g., \\u2019 for curly apostrophe, \\u201C for curly quote).",
            "items": {
              "type": "string"
            }
          },
          "machineTranslatedCount": {
            "type": "integer",
            "description": "Number of machine-translated strings for this locale"
          },
          "needsReviewCount": {
            "type": "integer",
            "description": "Number of strings marked as needing review for this locale"
          },
          "newCount": {
            "type": "integer",
            "description": "Number of strings that are untranslated for this locale"
          },
          "nextStep": {
            "type": "string",
            "description": "Suggestion of what tool to use next"
          },
          "requestedState": {
            "type": "string",
            "description": "The requested state bucket, or null if not requested"
          },
          "returnedCount": {
            "type": "integer",
            "description": "Number of keys returned after applying pagination"
          },
          "totalForRequestedState": {
            "type": "integer",
            "description": "Total number of keys in the requested state bucket before pagination, or null if not requested"
          },
          "translatedCount": {
            "type": "integer",
            "description": "Number of human-translated strings for this locale"
          }
        },
        "required": [
          "newCount",
          "needsReviewCount",
          "translatedCount",
          "machineTranslatedCount",
          "nextStep"
        ],
        "type": "object"
      }
    },
    {
      "name": "UpdateFileCompilerFlags",
      "title": "UpdateFileCompilerFlags",
      "description": "Updates, appends or deletes the additional per-file compiler flags for a single source file in a specific Xcode target — the same value shown in the Compiler Flags column of Target > Build Phases > Compile Sources.\n\nNote: Per-file compiler flags should never be used when target build settings would suffice. Only use per-file compiler flags sparingly, when adding a flag to a specific file is absolutely required and is the only way to solve a problem (e.g. incrementally adopting `-fbounds-safety` by applying it to a single file only). Prefer UpdateTargetBuildSetting in any other case.\n\nAlways use this tool to update per-file compiler flags — do not edit project.pbxproj directly.\n\nNote about Swift: Per-file compiler flags on Swift sources are typically ignored by the build system because the unit of compilation for Swift is a module. The value still round-trips through the project, but it may not affect builds. Prefer OTHER_SWIFT_FLAGS at the target level (use UpdateTargetBuildSetting).",
      "inputSchema": {
        "properties": {
          "appendValue": {
            "type": "boolean",
            "description": "Append the value to any existing compiler flags (separated by a single space) instead of replacing them. Has no effect when 'compilerFlags' is omitted."
          },
          "compilerFlags": {
            "type": "string",
            "description": "The additional compiler flags to set on the file, as a single space-separated string (e.g. \"-DFOO=1 -Wno-unused-variable\"). To delete all per-file compiler flags for the file, omit this property."
          },
          "filePath": {
            "type": "string",
            "description": "The path to the source file within the Xcode project organization (e.g., 'ProjectName/Sources/MyFile.swift'). An absolute or workspace-relative filesystem path is also accepted as a fallback."
          },
          "projectPath": {
            "type": "string",
            "description": "The project-organization path of the .xcodeproj that owns the target (e.g., 'MyApp/MyApp.xcodeproj'). Only needed when the same target name exists in multiple projects in the workspace; omit otherwise. An absolute or workspace-relative filesystem path is also accepted as a fallback."
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier."
          },
          "targetName": {
            "type": "string",
            "description": "The name of the Xcode target whose build phase contains the source file."
          }
        },
        "required": [
          "tabIdentifier",
          "targetName",
          "filePath"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "compilerFlags": {
            "type": "string",
            "description": "The compiler flags now set on the file, as a single space-separated string. Empty when the file has no per-file flags set after the update."
          },
          "filePath": {
            "type": "string",
            "description": "The project-organization path of the file."
          },
          "guidance": {
            "type": "string",
            "description": "Populated when a filesystem path was supplied for filePath or projectPath and resolved to a project-organization path. Contains instructions for the agent to prefer the resolved path in subsequent calls."
          },
          "previousFlags": {
            "type": "string",
            "description": "The compiler flags that were set on the file before this update, as a single space-separated string. Empty when no flags were set previously. Useful for confirming what changed without an extra GetFileCompilerFlags call."
          },
          "targetName": {
            "type": "string",
            "description": "The target whose per-file compiler flags were updated."
          },
          "warning": {
            "type": "string",
            "description": "Populated when the change was applied but the build system is unlikely to honor it (e.g. per-file flags on Swift sources, where the unit of compilation is a module). The flags are still written to the project file so the value reflects the agent's intent, but the agent should consider a target-level alternative."
          }
        },
        "required": [
          "targetName",
          "filePath",
          "compilerFlags",
          "previousFlags"
        ],
        "type": "object"
      }
    },
    {
      "name": "UpdateTargetBuildSetting",
      "title": "UpdateTargetBuildSetting",
      "description": "Updates, appends or deletes the named build setting for the specified Xcode project target.\nAlways use this tool to update/change the build settings for a target.\nIf you need to get build settings, always use the GetTargetBuildSettings tool.\n\nIMPORTANT: Do NOT try to modify the project.pbxproj file directly.\nIMPORTANT: Do NOT try to read the project.pbxproj file directly; use the GetTargetBuildSettings tool instead.\"",
      "inputSchema": {
        "properties": {
          "appendValue": {
            "type": "boolean",
            "description": "Append the value instead of replacing the current value."
          },
          "buildSettingName": {
            "type": "string",
            "description": "The build setting name to update or add."
          },
          "buildSettingValue": {
            "type": "string",
            "description": "The value to be added to build settings.\nDo not convert \"NO\" values to \"false\".\nTo delete the build setting instead, just skip this property."
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier."
          },
          "targetName": {
            "type": "string",
            "description": "The name of a given Xcode project target."
          }
        },
        "required": [
          "tabIdentifier",
          "targetName",
          "buildSettingName"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {},
        "required": [],
        "type": "object"
      }
    },
    {
      "name": "XcodeGetCurrentFile",
      "title": "Get Current File",
      "description": "Gets information about the currently active file in the Xcode editor including file path, content, and selection. Returns content in cat -n format with line numbers. Supports reading up to 600 lines by default with optional offset and limit parameters for large files.",
      "inputSchema": {
        "properties": {
          "includeContent": {
            "type": "boolean",
            "description": "Whether to include file content in the response"
          },
          "includeSelection": {
            "type": "boolean",
            "description": "Whether to include current selection information"
          },
          "limit": {
            "type": "integer",
            "description": "The number of lines to read (only provide if the file is too large to read at once)"
          },
          "offset": {
            "type": "integer",
            "description": "The line number to start reading from (only provide if the file is too large to read at once)"
          },
          "tabIdentifier": {
            "type": "string",
            "description": "Identifier for the workspace tab"
          }
        },
        "required": [
          "tabIdentifier"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "content": {
            "type": "string",
            "description": "Content of the current file formatted with line numbers (cat -n style)"
          },
          "filePath": {
            "type": "string",
            "description": "Full path to the current file"
          },
          "isEditable": {
            "type": "boolean",
            "description": "Whether the file is editable"
          },
          "linesRead": {
            "type": "integer",
            "description": "Number of lines actually read"
          },
          "selection": {
            "properties": {
              "characterRange": {
                "type": "object",
                "description": "Character range of the selection"
              },
              "lineRange": {
                "type": "object",
                "description": "Line range of the selection"
              },
              "text": {
                "type": "string",
                "description": "Selected text content"
              }
            },
            "required": [
              "text",
              "lineRange",
              "characterRange"
            ],
            "type": "object",
            "description": "Current selection information"
          },
          "startLine": {
            "type": "integer",
            "description": "The line number where reading started"
          },
          "totalLines": {
            "type": "integer",
            "description": "Total number of lines in the file"
          }
        },
        "required": [
          "isEditable"
        ],
        "type": "object"
      }
    },
    {
      "name": "XcodeGlob",
      "title": "Search Files",
      "description": "Finds files in the Xcode project structure matching wildcard patterns. Works on Xcode project organization, not filesystem structure. Example patterns: '*.swift', '**/*.json', 'src/**/*.{swift,m}'. If no pattern is provided, defaults to '**/*' (all files).",
      "inputSchema": {
        "properties": {
          "path": {
            "type": "string",
            "description": "Which project directory to search in (optional, defaults to root)"
          },
          "pattern": {
            "type": "string",
            "description": "File matching pattern using wildcards (* ** ? [abc] {swift,m}). Examples: '*.swift', '**/*.json', 'src/**/*.{swift,m}'. Defaults to '**/*' if not provided."
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          }
        },
        "required": [
          "tabIdentifier"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "matches": {
            "type": "array",
            "description": "List of matching file paths in the project structure (truncated at 100), sorted by most recently modified first",
            "items": {
              "type": "string"
            }
          },
          "message": {
            "type": "string",
            "description": "Optional message with additional information about the search results"
          },
          "packageDependencies": {
            "type": "array",
            "description": "Names of package dependencies whose files are included in results",
            "items": {
              "type": "string"
            }
          },
          "pattern": {
            "type": "string",
            "description": "The pattern that was searched for"
          },
          "searchPath": {
            "type": "string",
            "description": "The project path that was searched"
          },
          "totalFound": {
            "type": "integer",
            "description": "Total number of files found before truncation"
          },
          "truncated": {
            "type": "boolean",
            "description": "Whether results were truncated due to exceeding 100 files"
          }
        },
        "required": [
          "matches",
          "pattern",
          "searchPath",
          "truncated",
          "totalFound"
        ],
        "type": "object"
      }
    },
    {
      "name": "XcodeGrep",
      "title": "Search Content",
      "description": "Searches for text patterns in files within the Xcode project structure using regex. Works on Xcode project organization, not filesystem structure. CRITICAL: Must include a 'pattern' argument - this tool will fail without it. Input pattern uses standard regex syntax, not JSON escaping. To find \\d in source code, use pattern \\\\d. Output results are JSON-encoded e.g. backslashes, quotes, and newlines appear escaped (\\\\, \\\", \\n).",
      "inputSchema": {
        "properties": {
          "glob": {
            "type": "string",
            "description": "Only search files matching this pattern"
          },
          "headLimit": {
            "type": "integer",
            "description": "Stop after N results"
          },
          "ignoreCase": {
            "type": "boolean",
            "description": "Ignore case when matching"
          },
          "linesAfter": {
            "type": "integer",
            "description": "Show N lines after each match for context"
          },
          "linesBefore": {
            "type": "integer",
            "description": "Show N lines before each match for context"
          },
          "linesContext": {
            "type": "integer",
            "description": "Show N lines both before and after each match"
          },
          "multiline": {
            "type": "boolean",
            "description": "Allow patterns to span multiple lines"
          },
          "outputMode": {
            "type": "string",
            "description": "What to return: content, files_with_matches, or count (default: files_with_matches)",
            "enum": [
              "content",
              "filesWithMatches",
              "count"
            ]
          },
          "path": {
            "type": "string",
            "description": "Where to search - file or directory in project (defaults to root)"
          },
          "pattern": {
            "type": "string",
            "description": "Text to search for using regex. REQUIRED: Must include a 'pattern' argument - this tool will fail without it."
          },
          "showLineNumbers": {
            "type": "boolean",
            "description": "Show line numbers with results (content mode only)"
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          },
          "type": {
            "type": "string",
            "description": "Shortcut for common file types (swift, js, py, etc.)"
          }
        },
        "required": [
          "tabIdentifier",
          "pattern"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "matchCount": {
            "type": "integer",
            "description": "Total number of matches found"
          },
          "message": {
            "type": "string",
            "description": "Additional information about the search results"
          },
          "packageDependencies": {
            "type": "array",
            "description": "Names of package dependencies whose files are included in results",
            "items": {
              "type": "string"
            }
          },
          "pattern": {
            "type": "string",
            "description": "The pattern that was searched for"
          },
          "results": {
            "type": "array",
            "description": "Search results based on output mode",
            "items": {
              "type": "string"
            }
          },
          "searchPath": {
            "type": "string",
            "description": "The project path that was searched"
          },
          "truncated": {
            "type": "boolean",
            "description": "Whether results were truncated due to limits"
          }
        },
        "required": [
          "results",
          "pattern",
          "searchPath",
          "matchCount",
          "truncated"
        ],
        "type": "object"
      }
    },
    {
      "name": "XcodeLS",
      "title": "List Directory Contents",
      "description": "Lists files and directories in the Xcode project structure at the specified path. Works on Xcode project organization, not filesystem structure.",
      "inputSchema": {
        "properties": {
          "ignore": {
            "type": "array",
            "description": "Skip files/folders matching these patterns",
            "items": {
              "type": "string"
            }
          },
          "path": {
            "type": "string",
            "description": "The project path to browse (e.g., 'ProjectName/Sources/')"
          },
          "recursive": {
            "type": "boolean",
            "description": "Recursively list all files (truncated to 100 lines). Default: true"
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          }
        },
        "required": [
          "tabIdentifier",
          "path"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "items": {
            "type": "array",
            "description": "List of files and directories at the specified path",
            "items": {
              "type": "string"
            }
          },
          "message": {
            "type": "string",
            "description": "Optional message about the operation"
          },
          "packageDependencies": {
            "type": "array",
            "description": "Names of items that are package dependencies rather than regular project directories",
            "items": {
              "type": "string"
            }
          },
          "path": {
            "type": "string",
            "description": "The resolved project path that was browsed"
          }
        },
        "required": [
          "items",
          "path"
        ],
        "type": "object"
      }
    },
    {
      "name": "XcodeListNavigatorIssues",
      "title": "List Workspace Issues",
      "description": "Lists the currently known issues shown Xcode's Issue Navigator UI in the workspace. These issues include those that have been discovered since the last build, and also issues like package resolution problems and workspace configuration issues. You can filter the issues to include by file name, glob, or severity. Use this tool when you want to list all the users the user can see in the workspace UI.",
      "inputSchema": {
        "properties": {
          "glob": {
            "type": "string",
            "description": "Glob to filter the returned issues. Will match against the 'path' field."
          },
          "pattern": {
            "type": "string",
            "description": "Regex to filter the returned issues. Will match against the 'message' field."
          },
          "severity": {
            "type": "string",
            "description": "Limit the returned issues to those that have the specified severity or higher. Valid values in order of decreasing severity are 'error', 'warning', 'remark'. Defaults to 'error'."
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          }
        },
        "required": [
          "tabIdentifier"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "issues": {
            "type": "array",
            "description": "The list of current issues matching the input filters",
            "items": {
              "properties": {
                "category": {
                  "type": "string",
                  "description": "The category of the issue, if known"
                },
                "line": {
                  "type": "integer",
                  "description": "The line number where the issue was detected, if known"
                },
                "message": {
                  "type": "string",
                  "description": "The message describing the issue"
                },
                "path": {
                  "type": "string",
                  "description": "The file path where the issue was detected, if any"
                },
                "severity": {
                  "type": "string",
                  "description": "The severity of issue (error, warning, remark)"
                },
                "vitality": {
                  "type": "string",
                  "description": "Whether an issue from a previous build is known to still be relevant or whether something might have changed since it was emitted (for example if the source file has been edited and it isn't yet known whether that edit fixes the issue). Possible values: (fresh, stale)",
                  "enum": [
                    "fresh",
                    "stale"
                  ]
                }
              },
              "required": [
                "message",
                "severity"
              ],
              "type": "object"
            }
          },
          "message": {
            "type": "string",
            "description": "Optional message with additional information about the search results"
          },
          "totalFound": {
            "type": "integer",
            "description": "Total number of issues before truncation"
          },
          "truncated": {
            "type": "boolean",
            "description": "Whether results were truncated due to exceeding 100 issues"
          }
        },
        "required": [
          "issues",
          "truncated",
          "totalFound"
        ],
        "type": "object"
      }
    },
    {
      "name": "XcodeListRunDestinations",
      "title": "List Run Destinations",
      "description": "Lists run destinations available for the currently active scheme, grouped the same way the Xcode picker groups them (Devices, Simulators, Build, Incompatible, etc.), and identifies which one is active. Each entry includes the destination's `displayTitle` (matching the Xcode toolbar label and the unambiguous handle for XcodeSwitchRunDestination), its group, eligibility status, platform, OS version, architecture, and SDK display name. By default, destinations in the 'Incompatible' group are omitted from the inline list to save context (the `groups` summary still reports their count and the full file at fullRunDestinationListPath still contains them). Pass `includeIncompatible: true` to include them inline. The inline list is capped at 40 entries in both modes, with the active destination listed first; the complete list is always available via fullRunDestinationListPath.",
      "inputSchema": {
        "properties": {
          "includeIncompatible": {
            "type": "boolean",
            "description": "When true, destinations in the 'Incompatible' group are included in the inline `destinations` array. When false or omitted (the default), they are skipped to save context but are still counted in the `groups` summary and listed in fullRunDestinationListPath."
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier."
          }
        },
        "required": [
          "tabIdentifier"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "activeDestinationDisplayTitle": {
            "type": "string",
            "description": "The disambiguated displayTitle of the currently active run destination, or null if no destination is active. This value round-trips: pass it back to XcodeSwitchRunDestination to re-select the same destination."
          },
          "activeSchemeName": {
            "type": "string",
            "description": "The name of the currently active scheme, or null if no scheme is active. Run destinations are scoped to the active scheme."
          },
          "destinations": {
            "type": "array",
            "description": "Inline run destination entries. By default the 'Incompatible' group is omitted; pass `includeIncompatible: true` to include it. Always capped at 40 entries, with the active destination listed first.",
            "items": {
              "properties": {
                "architecture": {
                  "type": "string",
                  "description": "The destination's target architecture (for example, 'arm64' or 'x86_64')."
                },
                "displayTitle": {
                  "type": "string",
                  "description": "The destination's name as shown in the Xcode picker, including any disambiguation suffix when needed. This is the handle to pass back to XcodeSwitchRunDestination — it always round-trips."
                },
                "group": {
                  "type": "string",
                  "description": "The destination's group as shown in the picker (for example: 'Devices', 'Simulators', 'Virtual Machines', 'Build', 'Incompatible')."
                },
                "ineligibilityMessage": {
                  "type": "string",
                  "description": "Human-readable explanation of why this destination is ineligible, if any."
                },
                "isActive": {
                  "type": "boolean",
                  "description": "True if this is the currently active run destination."
                },
                "isEligible": {
                  "type": "boolean",
                  "description": "True if this destination can be used to build, run, or test the active scheme. Destinations in the 'Incompatible' group return false."
                },
                "isGenericDevice": {
                  "type": "boolean",
                  "description": "True if this destination represents a generic build target such as 'Any iOS Device'."
                },
                "isSimulator": {
                  "type": "boolean",
                  "description": "True if this destination represents a simulator device."
                },
                "osVersion": {
                  "type": "string",
                  "description": "The operating system version of the destination's device (for example, '18.4'), if known."
                },
                "platformIdentifier": {
                  "type": "string",
                  "description": "The platform identifier of the destination's device (for example, 'com.apple.platform.iphonesimulator')."
                },
                "sdkDisplayName": {
                  "type": "string",
                  "description": "The display name of the destination's target SDK (for example, 'iOS 18.4 Simulator')."
                }
              },
              "required": [
                "displayTitle",
                "group",
                "isActive",
                "isEligible",
                "isSimulator",
                "isGenericDevice"
              ],
              "type": "object"
            }
          },
          "fullRunDestinationListPath": {
            "type": "string",
            "description": "Path to a file containing every destination — including incompatible ones — in grep-friendly format."
          },
          "groups": {
            "type": "array",
            "description": "Summary of every destination group in picker order, each with a name and total count (independent of any inline filtering).",
            "items": {
              "properties": {
                "count": {
                  "type": "integer",
                  "description": "The number of run destinations in this group (independent of inline filtering)."
                },
                "name": {
                  "type": "string",
                  "description": "The group's display name as shown in the picker."
                }
              },
              "required": [
                "name",
                "count"
              ],
              "type": "object"
            }
          },
          "message": {
            "type": "string",
            "description": "Optional message explaining why the inline list differs from totalDestinations or noting other context (such as no active scheme)."
          },
          "totalDestinations": {
            "type": "integer",
            "description": "Total number of destinations available for the active scheme, before any filtering or truncation."
          },
          "truncated": {
            "type": "boolean",
            "description": "True if the inline `destinations` array contains fewer entries than `totalDestinations` (because of incompatible filtering, the 40-entry cap, or both)."
          }
        },
        "required": [
          "destinations",
          "groups",
          "truncated",
          "totalDestinations",
          "fullRunDestinationListPath"
        ],
        "type": "object"
      }
    },
    {
      "name": "XcodeListSchemes",
      "title": "List Schemes",
      "description": "Lists all schemes available in the current Xcode workspace and identifies which one is currently\nactive. Each entry includes the scheme's name, its sharing status (shared vs. user-only), and the\nproject or workspace container that holds it. Inline results are limited to 100\nschemes with the active scheme listed first; the complete list is always written to\nfullSchemeListPath in grep-friendly format with keys like SCHEME_NAME, DISAMBIGUATED_NAME,\nIS_ACTIVE, IS_SHARED, and CONTAINER_NAME. Use the XcodeSwitchScheme tool to change the active scheme.",
      "inputSchema": {
        "properties": {
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier."
          }
        },
        "required": [
          "tabIdentifier"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "activeSchemeName": {
            "type": "string",
            "description": "The name of the currently active scheme, or null if no scheme is active."
          },
          "fullSchemeListPath": {
            "type": "string",
            "description": "Path to a file containing the complete scheme list in grep-friendly format."
          },
          "message": {
            "type": "string",
            "description": "Optional message with additional information about truncation."
          },
          "schemes": {
            "type": "array",
            "description": "Visible, non-transient schemes in the workspace, limited to 100 entries with the active scheme listed first.",
            "items": {
              "properties": {
                "containerName": {
                  "type": "string",
                  "description": "The display name of the project or workspace container that hosts this scheme."
                },
                "disambiguatedName": {
                  "type": "string",
                  "description": "The scheme's name with the container name appended in parentheses when multiple schemes share the same name. Pass this value to XcodeSwitchScheme to resolve ambiguity."
                },
                "isActive": {
                  "type": "boolean",
                  "description": "True if this is the currently active scheme."
                },
                "isShared": {
                  "type": "boolean",
                  "description": "True if this scheme is shared (committed to source control alongside the project); false if it is a user-only scheme."
                },
                "name": {
                  "type": "string",
                  "description": "The scheme's name as it appears in the Xcode scheme picker."
                }
              },
              "required": [
                "name",
                "disambiguatedName",
                "isActive",
                "isShared"
              ],
              "type": "object"
            }
          },
          "totalSchemes": {
            "type": "integer",
            "description": "Total number of schemes before truncation."
          },
          "truncated": {
            "type": "boolean",
            "description": "True if the inline schemes array was truncated because more than 100 schemes exist."
          }
        },
        "required": [
          "schemes",
          "truncated",
          "totalSchemes",
          "fullSchemeListPath"
        ],
        "type": "object"
      }
    },
    {
      "name": "XcodeListWindows",
      "title": "List Windows",
      "description": "Lists the current Xcode windows and their workspace information",
      "inputSchema": {
        "properties": {},
        "required": [],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "message": {
            "type": "string",
            "description": "Description of all open Xcode windows"
          }
        },
        "required": [
          "message"
        ],
        "type": "object"
      }
    },
    {
      "name": "XcodeMV",
      "title": "Move File",
      "description": "Moves or renames files and directories in the project navigator with support for filesystem operations.",
      "inputSchema": {
        "properties": {
          "destinationPath": {
            "type": "string",
            "description": "Project navigator relative path for the destination (for move) or new name (for rename)"
          },
          "operation": {
            "properties": {
              "rawValue": {
                "type": "string",
                "description": "Move operation type"
              }
            },
            "required": [
              "rawValue"
            ],
            "type": "object",
            "description": "The type of move operation to perform",
            "enum": [
              "move",
              "copy"
            ]
          },
          "overwriteExisting": {
            "type": "boolean",
            "description": "Whether to overwrite existing files at the destination"
          },
          "sourcePath": {
            "type": "string",
            "description": "Project navigator relative path of the source item to move/rename"
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          }
        },
        "required": [
          "tabIdentifier",
          "sourcePath",
          "destinationPath"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "destinationFinalPath": {
            "type": "string",
            "description": "The final path of the moved/renamed item"
          },
          "message": {
            "type": "string",
            "description": "Result message describing the operation"
          },
          "operation": {
            "type": "string",
            "description": "The operation that was performed"
          },
          "sourceOriginalPath": {
            "type": "string",
            "description": "The original path of the source item"
          },
          "success": {
            "type": "boolean",
            "description": "Whether the move/rename operation succeeded"
          }
        },
        "required": [
          "success",
          "operation",
          "message"
        ],
        "type": "object"
      }
    },
    {
      "name": "XcodeMakeDir",
      "title": "Create Directory",
      "description": "Creates directories and groups in the Xcode project structure.",
      "inputSchema": {
        "properties": {
          "directoryPath": {
            "type": "string",
            "description": "Project navigator relative path for the directory to create"
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          }
        },
        "required": [
          "tabIdentifier",
          "directoryPath"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "createdPath": {
            "type": "string",
            "description": "The path of the created directory"
          },
          "message": {
            "type": "string",
            "description": "Result message describing the operation"
          },
          "success": {
            "type": "boolean",
            "description": "Whether the directory creation succeeded"
          }
        },
        "required": [
          "success",
          "message"
        ],
        "type": "object"
      }
    },
    {
      "name": "XcodeRM",
      "title": "Remove File",
      "description": "Removes files and directories from the Xcode project structure and optionally deletes the underlying files from the filesystem.",
      "inputSchema": {
        "properties": {
          "deleteFiles": {
            "type": "boolean",
            "description": "Also move the underlying files to Trash (defaults to true)"
          },
          "path": {
            "type": "string",
            "description": "The project path to remove (e.g., 'ProjectName/Sources/MyFile.swift')"
          },
          "recursive": {
            "type": "boolean",
            "description": "Remove directories and their contents recursively"
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          }
        },
        "required": [
          "tabIdentifier",
          "path"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "message": {
            "type": "string",
            "description": "Status message about the removal operation"
          },
          "removedPath": {
            "type": "string",
            "description": "The project path that was removed"
          },
          "success": {
            "type": "boolean",
            "description": "Whether the removal operation was successful"
          }
        },
        "required": [
          "removedPath",
          "success",
          "message"
        ],
        "type": "object"
      }
    },
    {
      "name": "XcodeRead",
      "title": "Read",
      "description": "Reads the contents of a file within the Xcode project organization. Returns content in cat -n format with line numbers. Supports reading up to 600 lines by default with optional offset and limit parameters for large files. Output is JSON-encoded e.g. backslashes, quotes, and newlines appear escaped (\\\\, \\\", \\n). Account for this when interpreting file content.",
      "inputSchema": {
        "properties": {
          "filePath": {
            "type": "string",
            "description": "The path to the file within the Xcode project organization (e.g., 'ProjectName/Sources/MyFile.swift')"
          },
          "limit": {
            "type": "integer",
            "description": "The number of lines to read (only provide if the file is too large to read at once)"
          },
          "offset": {
            "type": "integer",
            "description": "The line number to start reading from (only provide if the file is too large to read at once)"
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          }
        },
        "required": [
          "tabIdentifier",
          "filePath"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "content": {
            "type": "string",
            "description": "The file contents formatted with line numbers (cat -n style)"
          },
          "filePath": {
            "type": "string",
            "description": "The project path that was read"
          },
          "fileSize": {
            "type": "integer",
            "description": "Size of the file in bytes"
          },
          "linesRead": {
            "type": "integer",
            "description": "Number of lines actually read"
          },
          "message": {
            "type": "string",
            "description": "Optional message about the operation"
          },
          "startLine": {
            "type": "integer",
            "description": "The line number where reading started"
          },
          "totalLines": {
            "type": "integer",
            "description": "Total number of lines in the file"
          }
        },
        "required": [
          "content",
          "filePath",
          "totalLines",
          "linesRead",
          "startLine",
          "fileSize"
        ],
        "type": "object"
      }
    },
    {
      "name": "XcodeRefreshCodeIssuesInFile",
      "title": "XcodeRefreshCodeIssuesInFile",
      "description": "Retrieves current compiler diagnostics (errors, warnings, notes) for a file in the Xcode project. Returns formatted diagnostic information including severity levels and messages.",
      "inputSchema": {
        "properties": {
          "filePath": {
            "type": "string",
            "description": "The path to the file within the Xcode project organization (e.g., 'ProjectName/Sources/MyFile.swift')"
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          }
        },
        "required": [
          "tabIdentifier",
          "filePath"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "content": {
            "type": "string",
            "description": "Formatted diagnostic output with severity levels and messages"
          },
          "diagnosticsCount": {
            "type": "integer",
            "description": "Number of diagnostics found (errors, warnings, notes)"
          },
          "filePath": {
            "type": "string",
            "description": "The project path that was checked for diagnostics"
          },
          "success": {
            "type": "boolean",
            "description": "Whether the diagnostic retrieval completed successfully"
          }
        },
        "required": [
          "filePath",
          "diagnosticsCount",
          "content",
          "success"
        ],
        "type": "object"
      }
    },
    {
      "name": "XcodeSwitchRunDestination",
      "title": "Switch Run Destination",
      "description": "Changes the active run destination for the currently active scheme. The active scheme is left unchanged. Pass the destination's `displayTitle` (the disambiguated label shown in the Xcode picker). Valid sources: any `displayTitle` field returned by XcodeListRunDestinations, the list tool's `activeDestinationDisplayTitle` field, this tool's own `activeDestinationDisplayTitle` from a prior call, or XcodeSwitchScheme's `activeDestinationDisplayTitle` field — outputs from any of these chain back into this parameter without re-listing. Refuses to switch to a destination that is not eligible for the active scheme and reports the framework's reason. The output reflects Xcode's post-switch state.",
      "inputSchema": {
        "properties": {
          "displayTitle": {
            "type": "string",
            "description": "The destination's `displayTitle` — the disambiguated label shown in the Xcode picker. Round-trips through any of these prior tool outputs without needing a fresh XcodeListRunDestinations call: this tool's own `activeDestinationDisplayTitle`, XcodeSwitchScheme's `activeDestinationDisplayTitle`, or any `displayTitle` / `activeDestinationDisplayTitle` from XcodeListRunDestinations."
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier."
          }
        },
        "required": [
          "tabIdentifier",
          "displayTitle"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "activeDestinationDisplayTitle": {
            "type": "string",
            "description": "The disambiguated displayTitle of the run destination that is now active, read from Xcode after the switch (so it reflects any auto-resolution Xcode applied). This value round-trips through XcodeSwitchRunDestination."
          },
          "activeSchemeName": {
            "type": "string",
            "description": "The name of the scheme the run destination is associated with (unchanged by this action)."
          },
          "message": {
            "type": "string",
            "description": "A human-readable description of the result."
          }
        },
        "required": [
          "activeDestinationDisplayTitle",
          "activeSchemeName",
          "message"
        ],
        "type": "object"
      }
    },
    {
      "name": "XcodeSwitchScheme",
      "title": "Switch Scheme",
      "description": "Changes the active scheme in the current Xcode workspace to the specified scheme.\nAccepts either a scheme's name or its disambiguated name (needed when multiple schemes share the same name).\nUse the XcodeListSchemes tool to discover available scheme names.\nThe active run destination may be adjusted automatically when the previous one isn't compatible with the newly selected scheme — and Xcode may pick a different *variant* (for example, switching from \"My Mac\" to \"My Mac (Mac Catalyst)\") even when the destination's display name appears similar. The response's `activeDestinationDisplayTitle` matches what XcodeListRunDestinations returns, so callers can detect such auto-resolutions without a follow-up list call.",
      "inputSchema": {
        "properties": {
          "schemeName": {
            "type": "string",
            "description": "The name of the scheme to make active. To resolve ambiguity when multiple schemes share the same name, use the disambiguated name returned by XcodeListSchemes (for example, \"MyScheme (MyProject)\")."
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier."
          }
        },
        "required": [
          "tabIdentifier",
          "schemeName"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "activeDestinationDisplayTitle": {
            "type": "string",
            "description": "The disambiguated displayTitle of the active run destination — the same string XcodeListRunDestinations returns. Use this to detect when Xcode auto-resolved the destination to a different variant (e.g. from 'My Mac' to 'My Mac (Mac Catalyst)') because the previous destination wasn't compatible with the new scheme."
          },
          "activeSchemeName": {
            "type": "string",
            "description": "The name of the scheme that is now active."
          },
          "message": {
            "type": "string",
            "description": "A human-readable description of the result."
          }
        },
        "required": [
          "activeSchemeName",
          "message"
        ],
        "type": "object"
      }
    },
    {
      "name": "XcodeUpdate",
      "title": "Edit File",
      "description": "Edits files in the Xcode project by replacing text content. Works on Xcode project structure paths, not filesystem paths. IMPORTANT: The tool will fail if filePath, oldString, or newString parameters are missing. Input oldString and newString use literal characters e.g. if XcodeRead shows \\\\d, use \\d in parameters to match it.",
      "inputSchema": {
        "properties": {
          "filePath": {
            "type": "string",
            "description": "REQUIRED: The path to the file to modify within the Xcode project organization (e.g., 'ProjectName/Sources/MyFile.swift')"
          },
          "newString": {
            "type": "string",
            "description": "REQUIRED: The text to replace it with, must be different from oldString"
          },
          "oldString": {
            "type": "string",
            "description": "REQUIRED: The text to replace"
          },
          "replaceAll": {
            "type": "boolean",
            "description": "Replace all occurrences of oldString (default false)"
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier"
          }
        },
        "required": [
          "tabIdentifier",
          "filePath",
          "oldString",
          "newString"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "editsApplied": {
            "type": "integer",
            "description": "Number of successful text replacements made"
          },
          "filePath": {
            "type": "string",
            "description": "The path of the file that was edited"
          },
          "message": {
            "type": "string",
            "description": "Optional message with additional information about the edit results"
          },
          "modifiedContentLength": {
            "type": "integer",
            "description": "Length of the file content after editing"
          },
          "originalContentLength": {
            "type": "integer",
            "description": "Length of the file content before editing"
          },
          "success": {
            "type": "boolean",
            "description": "Whether the edit operation completed successfully"
          }
        },
        "required": [
          "filePath",
          "editsApplied",
          "success",
          "originalContentLength",
          "modifiedContentLength"
        ],
        "type": "object"
      }
    },
    {
      "name": "XcodeWrite",
      "title": "Write File",
      "description": "Creates or overwrites files with content in the Xcode project. Works on Xcode project structure paths, not filesystem paths. Automatically adds new files to the project structure. Both filePath and content parameters are required. Input content uses literal characters e.g. if XcodeRead shows \\\\d, use \\d in the content parameter to write it.",
      "inputSchema": {
        "properties": {
          "content": {
            "type": "string",
            "description": "REQUIRED: The content to write to the file"
          },
          "filePath": {
            "type": "string",
            "description": "REQUIRED: The path to the file within the Xcode project organization (e.g., 'ProjectName/Sources/MyFile.swift')"
          },
          "tabIdentifier": {
            "type": "string",
            "description": "The workspace tab identifier (required)"
          }
        },
        "required": [
          "tabIdentifier",
          "filePath",
          "content"
        ],
        "type": "object"
      },
      "outputSchema": {
        "properties": {
          "absolutePath": {
            "type": "string",
            "description": "The absolute file system path of the written file"
          },
          "bytesWritten": {
            "type": "integer",
            "description": "Number of bytes written to the file"
          },
          "filePath": {
            "type": "string",
            "description": "The project path that was written"
          },
          "linesWritten": {
            "type": "integer",
            "description": "Number of lines written to the file"
          },
          "message": {
            "type": "string",
            "description": "Result message describing the write operation"
          },
          "success": {
            "type": "boolean",
            "description": "Whether the file write operation succeeded"
          },
          "wasExistingFile": {
            "type": "boolean",
            "description": "Whether the file existed before writing"
          }
        },
        "required": [
          "success",
          "filePath",
          "bytesWritten",
          "linesWritten",
          "message",
          "wasExistingFile"
        ],
        "type": "object"
      }
    }
  ]
}