Skip to content

Release v2.1.0

Latest

Choose a tag to compare

@github-actions github-actions released this 23 Feb 13:16

Release v2.1.0

Added

  • Added xcodebuildmcp init CLI command to install agent skills, replacing the standalone install-skill.sh script. Supports auto-detection of AI clients (Claude Code, Cursor, Codex), --print for unsupported clients, and --uninstall for removal. See docs/SKILLS.md.
  • Added namespaced session defaults profiles, letting you save and switch between different project/scheme/simulator configurations without reconfiguring each time. See docs/SESSION_DEFAULTS.md.
  • Added support for persisting custom environment variables in session defaults (#235 by @kamal). See docs/SESSION_DEFAULTS.md.
  • Added Kiro client setup instructions (#222 by @manojmahapatra).

Changed

  • Faster MCP startup when the Xcode IDE workflow is enabled — tools are available sooner after connecting (#210). See docs/XCODE_IDE_MCPBRIDGE.md.
  • Agents now use the combined build-and-run tool for simulator run intents, avoiding a redundant separate build step.
  • Improved next-step suggestions so agents receive more accurate follow-up actions after each tool call.
  • Updated UI automation tap guidance to prefer label and ID targets, reducing agent errors.

Fixed

  • Fixed false positive error and warning detection when build output contained echoed source code (#218 by @nebooz).
  • Fixed outdated tool names and parameters in the CLI skill file (#217 by @pocketpixels).
  • Fixed Sentry telemetry scope to capture only internal runtime failures, removing unnecessary data collection (#204).
  • Fixed a shell injection vulnerability in the release workflow (#229).
  • Improved privacy redaction in the doctor command to better protect project names and paths in default output.

Removed

  • Removed scripts/install-skill.sh in favour of xcodebuildmcp init.

Various other internal improvements to stability, performance, and code quality.

Option A — Homebrew (no Node.js required)

Install:

brew tap getsentry/xcodebuildmcp
brew install xcodebuildmcp

MCP config:

"XcodeBuildMCP": {
  "command": "xcodebuildmcp",
  "args": ["mcp"]
}

Option B — npm / npx (Node.js 18+)

Install:

npm install -g xcodebuildmcp@latest

MCP config:

"XcodeBuildMCP": {
  "command": "npx",
  "args": ["-y", "xcodebuildmcp@latest", "mcp"]
}

📦 NPM Package: https://www.npmjs.com/package/xcodebuildmcp/v/2.1.0