iPhone-use changelog: what's new each month
Every stable iPhone-use release summarised by month: the highlights, new features, improvements, fixes and anything you need to act on. 1 month covered; the current month updates daily.
October 2026
34 releases: 0.1.0 → 0.3.16
October brought iPhone Use from initial release to a stable feature-complete tool for AI-driven iPhone control. The month focused on core functionality, UI refinement, and analytics integration.
Action needed
- Tool names changed from wda_* to pua_* (Phone Use Agent) prefix.
- Default max_nodes parameter changed from unconstrained to 200; explicit max_nodes setting remains supported up to 500.
- READY and setup tool results merged into single iphone_use_tool_called event; no separate result events.
- Analytics enabled by default; disable via IPHONE_USE_ANALYTICS=0 or DO_NOT_TRACK=1.
Highlights
- Real iPhone control through WebDriverAgent with 18 tools for app launching, scrolling, input, and observation.
- Live phone screen preview in the chat interface with gesture support and Dynamic Island.
- Unified tool naming (pua_* prefix) and improved error handling for authentication, connectivity, and incomplete actions.
- Analytics integration tracking tool usage, app launches, and setup flows without capturing sensitive data.
- Long-text input robustness and screenshot fallback for scroll and verification scenarios.
New
- Phone screen widget with real-time MJPEG stream, click/drag/scroll gesture support, and Dynamic Island display.
- AirDrop guide for transferring files from iPhone to Mac.
- App launch event tracking with bundle ID and launch source attribution.
- Explicit viewport recovery and short-term frame retention during disconnection.
- Support for independent native snapshot depth and child-node limits in observation.
- PostHog and GA4 analytics backend with usage reporting and dashboard.
- 18 model tools and 2 widget tools with unified schema and 200-node default observation budget.
- MCP tool initialize request retry with persistent loading state.
Improved
- Scroll behavior now constrains to native modal regions and validates modal context after gestures.
- Home button now uses dedicated WDA homescreen endpoint with SpringBoard foreground verification.
- Custom scroll freshness compares target region and handles unrelated carousels.
- App activation polls for foreground state up to five seconds.
- Swipe observation support and selector enabled checks with safe NSPredicate encoding.
- Long-text input confirms original app, WDA session, and input focus before continuing.
- Setup and READY flows reuse existing phone screen tabs within a conversation.
- Installed app discovery using wda_apps tool with verified 36-app bundle ID catalog.
Fixed
- USB socket pause after usbmux handoff now resumes HTTP parser read.
- Animation pause respect for reduced-motion preference.
- Plugin initialization to load correct tool count and schema after MCP reconnect.
- Widget blank screen issue when phone control is active.
- shell-quote dependency vulnerability (GHSA-pqg4-j6r4-53mv) pinned to 1.11.0.
- Inconsistent installed app list parsing for both list and dict responses.
Summaries are written automatically from the official release notes (full changelog ↗); check the original notes before relying on a detail. iPhone-use: pricing, features and alternatives · All changelogs