Getting Started

From install to your first AI-controlled session in under five minutes. Follow these steps in order.

1

Download Haptix for Mac

Download the Haptix macOS app. Drag it to your Applications folder and launch it — it runs in your menu bar. A free trial starts on first launch, no credit card required.

Download for macOSAll releases →

Requires macOS 15.0+ (Sequoia) and Apple Silicon.

2

Add HaptixKit to your project

Add the HaptixKit Swift Package to your project.

  1. Go to File → Add Package Dependencies
  2. Paste the package URL below
  3. Click Add Package

Package URL

https://github.com/haptix-dev/HaptixKit
Note: Only link HaptixKit to your Debug configuration. In your target's Build Phases, you can set the framework to optional, or use a conditional dependency to exclude it from Release builds entirely.
3

Add Haptix to your app

Add Haptix.start(license:) to your app's init(), wrapped in #if DEBUG. Use the trial key from the Haptix app, or the license key from your purchase.

MyApp.swift
1#if DEBUG
2import HaptixKit
3#endif
4
5@main
6struct MyApp: App {
7 init() {
8 #if DEBUG
9 Haptix.start(license: "HPTX-XXXX-XXXX-XXXX")
10 #endif
11 }
12
13 var body: some Scene {
14 WindowGroup {
15 ContentView()
16 }
17 }
18}

Wrap in #if DEBUG to exclude from production builds. App Review may reject apps that include development tools, and it would expose a remote control surface to your users.

4

Prepare your device

On your physical iPhone or iPad, enable two settings:

  1. Developer Mode — Settings → Privacy & Security → Developer Mode → toggle on
  2. UI Automation — Settings → Developer → Enable UI Automation → toggle on
Note: Simulators don't require these settings — you can skip this step if you're testing on Simulator only.
5

Start the Haptix server

Launch the Haptix app on your Mac if it isn't already running. It lives in your menu bar and starts the MCP server automatically on localhost:4278. Start a free trial or enter your license key in the Haptix onboarding if you haven't already.

6

Configure your AI agent

Add the Haptix MCP server to your AI agent's configuration. Pick your agent below and copy the config:

.cursor/mcp.json
1{
2 "mcpServers": {
3 "haptix": {
4 "url": "http://localhost:4278/mcp"
5 }
6 }
7}
7

Build, run, and go

Connect your device via USB, then build and run your app from Xcode. The Haptix daemon discovers your device automatically — no configuration needed.

You're ready. Your AI agent can now take screenshots, tap, swipe, type, and read the accessibility tree — all on your real device or Simulator.