# Changelog
All notable changes to the iOS Development Tools plugin will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [0.4.0] - 2026-01-13
### Added
- Input Simulation tools (3 tools)
- `simulator_type_text` - Type text into focused text fields
- `simulator_press_home` - Press home button to return to home screen
- `simulator_send_keys` - Send hardware keyboard shortcuts (cmd-h, cmd-l, etc.)
- Hardware button simulation support
- Keyboard shortcut mapping for common actions
- Text input validation and error handling
### Improved
- Extended tool count from 14 to 17 tools
- Complete basic simulator interaction coverage
- Enhanced input method flexibility
## [0.3.0] - 2026-01-13
### Added
- App Management tools (6 tools)
- `simulator_launch_app` - Launch apps by bundle identifier with process ID capture
- `simulator_terminate_app` - Force quit running apps
- `simulator_install_app` - Install .app bundles with path validation
- `simulator_uninstall_app` - Remove apps and their data
- `simulator_open_url` - Open URLs, deep links, and universal links
- `simulator_get_logs` - Retrieve filtered log entries with predicate support
- Bundle identifier-based app control
- Log filtering by process, bundle ID, and log level
- Deep link and universal link testing support
- Comprehensive error handling for app lifecycle operations
### Improved
- Extended tool count from 8 to 14 tools
- Enhanced error messages for app installation failures
- Added path validation for .app bundles
- Graceful handling of already-terminated/uninstalled apps
## [0.2.0] - 2026-01-13
### Added
- UI Interaction tools (4 tools)
- `simulator_screenshot` - Capture screenshots with automatic JPEG compression
- `simulator_tap` - Tap at specific coordinates
- `simulator_swipe` - Perform swipe gestures with direction detection
- `simulator_long_press` - Long press for context menus and drag operations
- Screenshot compression using sharp library
- Automatic PNG to JPEG conversion
- Quality control (default 80%)
- Size constraints (max 800x1400px)
- Compression ratio reporting (typically 80% smaller)
- Gesture direction detection for swipes
- Coordinate validation and error handling
### Improved
- Extended tool count from 4 to 8 tools
- Enhanced error messages with recovery suggestions
- Added compression metadata to screenshot responses
## [0.1.0] - 2026-01-13
### Added
- Initial release of iOS Development Tools plugin
- Simulator device management (4 tools)
- `simulator_list_devices` - List all available iOS simulators
- `simulator_boot` - Boot a simulator device
- `simulator_shutdown` - Shutdown a running simulator
- `simulator_get_info` - Get detailed device information
- Smart device resolution ("booted" keyword support)
- Structured error handling with recovery suggestions
- Type-safe tool definitions with Zod validation
- Comprehensive documentation and setup guides
- Automated installation script for local setup
- Setup verification script
### Platform Support
- macOS only (iOS Simulator requirement)
- Node.js 18+ required
- Xcode 15+ with Command Line Tools required
### Known Limitations
- UI automation tools (screenshots, taps, swipes) - Coming in v0.2.0
- App lifecycle management - Coming in v0.2.0
- Build and test automation - Coming in v0.3.0
- Project management tools - Coming in v0.4.0
## [Unreleased]
### Planned for v0.2.0
- Screenshot capture with JPEG compression
- UI interaction (tap, swipe, long press)
- App installation and launch
- Log streaming with filtering
- Text input simulation
### Planned for v0.3.0
- Xcodebuild integration
- Test execution and result parsing
- Coverage generation
- Build configuration management
### Planned for v0.4.0
- Xcode project management
- File and group operations
- Info.plist editing
- Swift Package Manager integration
## Version History
- **0.4.0** - Input simulation tools (text input, hardware buttons, keyboard shortcuts)
- **0.3.0** - App management tools (launch, install, terminate, logs)
- **0.2.0** - UI interaction tools (screenshots, gestures)
- **0.1.0** - Initial release with core simulator device management
---
[0.4.0]: https://github.com/dagba/ios-mcp/releases/tag/v0.4.0
[0.3.0]: https://github.com/dagba/ios-mcp/releases/tag/v0.3.0
[0.2.0]: https://github.com/dagba/ios-mcp/releases/tag/v0.2.0
[0.1.0]: https://github.com/dagba/ios-mcp/releases/tag/v0.1.0
[Unreleased]: https://github.com/dagba/ios-mcp/compare/v0.4.0...HEAD
