Skip to content

CHANGELOG.md

Latest commit

 

History

History
191 lines (149 loc) · 8.19 KB

CHANGELOG.md

File metadata and controls

191 lines (149 loc) · 8.19 KB

Changelog

[Unreleased]

Added

  • build_device tool: Added optional platform parameter to support building for iOS, visionOS, watchOS, and tvOS devices. Previously hardcoded to iOS only, this enhancement enables proper building for Apple Vision Pro and other platforms. Example: build_device({ projectPath: '/path/to/project.xcodeproj', scheme: 'MyScheme', platform: 'visionOS' })

[1.14.1] - 2025-10-12

Fixed

  • test_sim tool: Added helpful error message when users try to use platform: "macOS" with test_sim, directing them to use the test_macos tool instead. This prevents confusing enum validation errors and improves user experience.

[1.14.0] - 2025-09-22

  • Add video capture tool for simulators

[1.13.1] - 2025-09-21

  • Add simulator erase content and settings tool

[1.12.3] - 2025-08-22

  • Pass environment variables to test runs on device, simulator, and macOS via an optional testRunnerEnv input (auto-prefixed as TEST_RUNNER_).

[1.12.2] - 2025-08-21

Fixed

  • Clean tool: Fixed issue where clean would fail for simulators

[1.12.1] - 2025-08-18

Improved

  • Sentry Logging: No longer logs domain errors to Sentry, now only logs MCP server errors.

[1.12.0] - 2025-08-17

Added

  • Unify project/workspace and sim id/name tools into a single tools reducing the number of tools from 81 to 59, this helps reduce the client agent's context window size by 27%!
  • Selective Workflow Loading: New XCODEBUILDMCP_ENABLED_WORKFLOWS environment variable allows loading only specific workflow groups in static mode, reducing context window usage for clients that don't support MCP sampling (Thanks to @codeman9 for their first contribution!)
  • Rename diagnosics tool and cli to doctor
  • Add Sentry instrumentation to track MCP usage statistics (can be disabled by setting XCODEBUILDMCP_SENTRY_DISABLED=true)
  • Add support for MCP setLevel handler to allow clients to control the log level of the MCP server

[v1.11.2] - 2025-08-08

  • Fixed "registerTools is not a function" errors during package upgrades

[v1.11.1] - 2025-08-07

  • Improved tool discovery to be more accurate and context-aware

[v1.11.0] - 2025-08-07

  • Major refactor/rewrite to improve code quality and maintainability in preparation for future development
  • Added support for dynamic tools (VSCode only for now)
  • Added support for MCP Resources (devices, simulators, environment info)
  • Workaround for getsentry#66 and anthropics/claude-code#1804 issues where Claude Code would only see the first text content from tool responses

[v1.10.0] - 2025-06-10

Added

  • App Lifecycle Management: New tools for stopping running applications
    • stop_app_device: Stop apps running on physical Apple devices (iPhone, iPad, Apple Watch, Apple TV, Apple Vision Pro)
    • stop_app_sim: Stop apps running on iOS/watchOS/tvOS/visionOS simulators
    • stop_mac_app: Stop macOS applications by name or process ID
  • Enhanced Launch Tools: Device launch tools now return process IDs for better app management
  • Bundled AXe Distribution: AXe binary and frameworks now included in npm package for zero-setup UI automation

Fixed

  • WiFi Device Detection: Improved detection of Apple devices connected over WiFi networks
  • Device Connectivity: Better handling of paired devices with different connection states

Improved

  • Simplified Installation: No separate AXe installation required - everything works out of the box

[v1.9.0] - 2025-06-09

  • Added support for hardware devices over USB and Wi-Fi
  • New tools for Apple device deployment:
    • install_app_device
    • launch_app_device
  • Updated all simulator and device tools to be platform-agnostic, supporting all Apple platforms (iOS, iPadOS, watchOS, tvOS, visionOS)
  • Changed get_ios_bundle_id to get_app_bundle_id with support for all Apple platforms

[v1.8.0] - 2025-06-07

  • Added support for running tests on macOS, iOS simulators, and iOS devices
  • New tools for testing:
    • test_macos_workspace
    • test_macos_project
    • test_ios_simulator_name_workspace
    • test_ios_simulator_name_project
    • test_ios_simulator_id_workspace
    • test_ios_simulator_id_project
    • test_ios_device_workspace
    • test_ios_device_project

[v1.7.0] - 2025-06-04

  • Added support for Swift Package Manager (SPM)
  • New tools for Swift Package Manager:
    • swift_package_build
    • swift_package_clean
    • swift_package_test
    • swift_package_run
    • swift_package_list
    • swift_package_stop

[v1.6.1] - 2025-06-03

  • Improve UI tool hints

[v1.6.0] - 2025-06-03

  • Moved project templates to external GitHub repositories for independent versioning
  • Added support for downloading templates from GitHub releases
  • Added local template override support via environment variables
  • Added scaffold_ios_project and scaffold_macos_project tools for creating new projects
  • Centralized template version management in package.json for easier updates

[v1.5.0] - 2025-06-01

  • UI automation is no longer in beta!
  • Added support for AXe UI automation
  • Revised default installation instructions to prefer npx instead of mise

[v1.4.0] - 2025-05-11

  • Merge the incremental build beta branch into main
  • Add preferXcodebuild argument to build tools with improved error handling allowing the agent to force the use of xcodebuild over xcodemake for complex projects. It also adds a hint when incremental builds fail due to non-compiler errors, enabling the agent to automatically switch to xcodebuild for a recovery build attempt, improving reliability.

[v1.3.7] - 2025-05-08

  • Fix Claude Code issue due to long tool names

[v1.4.0-beta.3] - 2025-05-07

  • Fixed issue where incremental builds would only work for "Debug" build configurations

[v1.4.0-beta.2] - 2025-05-07

  • Same as beta 1 but has the latest features from the main release channel

[v1.4.0-beta.1] - 2025-05-05

  • Added experimental support for incremental builds (requires opt-in)

[v1.3.6] - 2025-05-07

  • Added support for enabling/disabling tools via environment variables

[v1.3.5] - 2025-05-05

  • Fixed the text input UI automation tool
  • Improve the UI automation tool hints to reduce agent tool call errors
  • Improved the project discovery tool to reduce agent tool call errors
  • Added instructions for installing idb client manually

[v1.3.4] - 2025-05-04

  • Improved Sentry integration

[v1.3.3] - 2025-05-04

  • Added Sentry opt-out functionality

[v1.3.1] - 2025-05-03

  • Added Sentry integration for error reporting

[v1.3.0] - 2025-04-28

  • Added support for interacting with the simulator (tap, swipe etc.)
  • Added support for capturing simulator screenshots

Please note that the UI automation features are an early preview and currently in beta your mileage may vary.

[v1.2.4] - 2025-04-24

  • Improved xcodebuild reporting of warnings and errors in tool response
  • Refactor build utils and remove redundant code

[v1.2.3] - 2025-04-23

  • Added support for skipping macro validation

[v1.2.2] - 2025-04-23

  • Improved log readability with version information for easier debugging
  • Enhanced overall stability and performance

[v1.2.1] - 2025-04-23

  • General stability improvements and bug fixes

[v1.2.0] - 2025-04-14

Added

  • New simulator log capture feature: Easily view and debug your app's logs while running in the simulator
  • Automatic project discovery: XcodeBuildMCP now finds your Xcode projects and workspaces automatically
  • Support for both Intel and Apple Silicon Macs in macOS builds

Improved

  • Cleaner, more readable build output with better error messages
  • Faster build times and more reliable build process
  • Enhanced documentation with clearer usage examples

[v1.1.0] - 2025-04-05

Added

  • Real-time build progress reporting
  • Separate tools for iOS and macOS builds
  • Better workspace and project support

Improved

  • Simplified build commands with better parameter handling
  • More reliable clean operations for both projects and workspaces

[v1.0.2] - 2025-04-02

  • Improved documentation with better examples and clearer instructions
  • Easier version tracking for compatibility checks

[v1.0.1] - 2025-04-02

  • Initial release of XcodeBuildMCP
  • Basic support for building iOS and macOS applications