Setup Guide

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 from the releases page or grab the latest directly:

• Download Haptix.dmg

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.

Requires macOS 15.0+ (Sequoia) and Apple Silicon. See System Requirements for full details.

2. Add HaptixKit to your project

Add the HaptixKit Swift Package to your Xcode project.

Using Xcode

1. Go to File → Add Package Dependencies
2. Paste the package URL: https://github.com/haptix-dev/HaptixKit
3. Click Add Package

Using Package.swift

Add HaptixKit to your Package.swift dependencies:

dependencies: [
    .package(
        url: "https://github.com/haptix-dev/HaptixKit",
        from: "1.2.0"
    )
]

Only link HaptixKit to your Debug configuration. In your target's Build Phases, 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.

#if DEBUG
import HaptixKit
#endif

@main
struct MyApp: App {
    init() {
        #if DEBUG
        Haptix.start(license: "HPTX-XXXX-XXXX-XXXX")
        #endif
    }

    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

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.

SDK parameters

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

Simulators don't require these settings — you can skip this step if you're testing on Simulator only.

5. Connect via USB

Connect your iPhone or iPad to your Mac with a USB cable. Haptix discovers USB devices automatically — no network configuration needed.

6. 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. You can also start a trial from the terminal with haptix trial.

7. Configure your AI agent

Add the Haptix MCP server to your AI agent's configuration. See the full MCP Setup page for all supported agents, or use the quick config below:

{
  "mcpServers": {
    "haptix": {
      "url": "http://localhost:4278/mcp"
    }
  }
}

This works for Cursor (.cursor/mcp.json), VS Code (.vscode/mcp.json), and Claude Desktop.

8. Build, run, and go

Build and run your app from Xcode on your USB-connected device or Simulator. The daemon discovers your device and connects automatically.

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.