Releases

Fixes a connection drop that could happen when zooming out on a targeted element, and fixes console-output filters (contains, source, level, limit) being ignored. In-app menus now open correctly on tap, picker wheels respond to gestures, and content hidden behind the on-screen keyboard is detected and handled. The background service now recovers on its own from screen-capture interruptions and continuously checks its own health, so it no longer needs a manual restart after a hiccup.

Install or upgrade: curl -fsSL https://get.haptix.dev/install.sh | bash

Fixes a hang on apps with very large or deeply nested screens — long infinite-scroll feeds especially — where gestures and reading the screen could previously stall for up to two minutes. Gestures and accessibility-tree reads are now near-instant on those screens, and tree reads respect the depth you ask for.

Install or upgrade: curl -fsSL https://get.haptix.dev/install.sh | bash

Reliability fix for multi-device sessions. When two iPhones are plugged into the same Mac, sessions now bind correctly even under heavy concurrent screenshot use, and recover automatically if a device connection is restarted mid-session.

Selecting a device by name with haptix session start --device <name> now handles names containing spaces, and returns an error when the query matches more than one device instead of silently choosing one.

Install or upgrade: curl -fsSL https://get.haptix.dev/install.sh | bash

Fixes multi-device selection from the CLI. haptix session start --device <udid-or-name> and --force now actually take effect when two or more iPhones are connected to the same Mac. Before this release, both flags were silently dropped and the CLI fell through to a "which device?" error whenever it saw more than one phone.

Install or upgrade: curl -fsSL https://get.haptix.dev/install.sh | bash

Fixes a multi-device routing issue where two iPhones connected to the same Mac could see each other's screenshots under concurrent agent use. Sessions now bind to a per-device capture source at start time, so frames from one phone can never appear in another session. If two phones share a name, the daemon refuses to bind and asks you to rename one in iOS Settings.

Install or upgrade: curl -fsSL https://get.haptix.dev/install.sh | bash

Recovery and reliability release. Adds haptix device reset and haptix capture repair for clearing stuck state without restarting your phone or Mac, plus haptix errors for looking up what every Haptix error code means and how to recover from it. Sessions that get force-claimed by another agent now wait for the prior capture to release cleanly, and rapid back-and-forth claims are rate-limited so the system can't get pushed into a state that needs a reboot. The same actions are available to AI agents over MCP: reset_device, repair_capture, list_diagnostics, describe_diagnostic. haptix session end accepts --reset to clear on-device state in one step.

Install or upgrade: curl -fsSL https://get.haptix.dev/install.sh | bash

Three small follow-ups to v1.5.3.

haptix tools lists every MCP tool the daemon currently exposes. Useful when an in-flight AI client cached its tool list from before the daemon was upgraded and doesn't see the new ones.

start_session now accepts an optional force: true to recover from a stale session lock left behind by a script that crashed mid-run. Default behavior is unchanged for normal callers — force is opt-in.

The annotated screenshot tool's element-index output is sent as separate content blocks instead of one concatenated block, which keeps strict JSON parsers in the field happy.

Install or upgrade: curl -fsSL https://get.haptix.dev/install.sh | bash

Installer reliability — the curl install now succeeds consistently across machine configurations, including an edge case where the previous installer could reject its own freshly downloaded binary.

Install or upgrade: curl -fsSL https://get.haptix.dev/install.sh | bash

Makes the daemon install and run reliably on current macOS.

Older builds could fail to start as a background service on the latest macOS. v1.5.2 fixes that, so a fresh install comes up cleanly and stays running across restarts.

Install or upgrade: curl -fsSL https://get.haptix.dev/install.sh | bash

Four agent-quality improvements in one release.

The agent's MCP system context now leads with two operating rules — act only on what is visibly on screen, and ask the user when two or three reasonable attempts haven't worked. Agents stay grounded in the most recent screenshot instead of acting on stale accessibility-tree assumptions, and they check in instead of looping.

Annotated screenshots now work on any iOS app without HaptixKit embedded. Box-and-label overlays are composed Mac-side on the captured frame, so visual debugging works on apps you don't own.

Long gestures stay alive. A multi-second draw_path through many waypoints now streams MCP notifications/progress frames as it runs, so subscribing clients see in-flight state instead of waiting silently.

find_element and accessibility-tree reads are sub-second on dense screens like social feeds and Settings.

Install or upgrade: curl -fsSL https://get.haptix.dev/install.sh | bash

v1.5.0 moves licensing into the daemon and aligns version numbers across the stack.

The license key now lives with the Haptix daemon instead of being passed in by the iOS SDK. If you're embedding HaptixKit, the license: parameter on Haptix.start(...) is now ignored — leave existing code as-is and the daemon authenticates on its own.

Daemon, CLI, on-device agent, and SDK all ship at the same version from this release forward, which removes the version-mismatch warnings between the pieces.

Install or upgrade: curl -fsSL https://get.haptix.dev/install.sh | bash

Major update: MCP integration improvements, CLI exposed as first-class tool, new annotation commands, build 5.

Initial release — HaptixKit SDK and Haptix macOS companion app