Release v2.1.0
Added
- Added
xcodebuildmcp initCLI command to install agent skills, replacing the standaloneinstall-skill.shscript. Supports auto-detection of AI clients (Claude Code, Cursor, Codex),--printfor unsupported clients, and--uninstallfor 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
doctorcommand to better protect project names and paths in default output.
Removed
- Removed
scripts/install-skill.shin favour ofxcodebuildmcp 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 xcodebuildmcpMCP config:
"XcodeBuildMCP": {
"command": "xcodebuildmcp",
"args": ["mcp"]
}Option B — npm / npx (Node.js 18+)
Install:
npm install -g xcodebuildmcp@latestMCP config:
"XcodeBuildMCP": {
"command": "npx",
"args": ["-y", "xcodebuildmcp@latest", "mcp"]
}📦 NPM Package: https://www.npmjs.com/package/xcodebuildmcp/v/2.1.0