System Requirements
Everything you need to run Haptix.
Haptix for Mac (MCP Server)
| Requirement | Minimum |
|---|---|
| macOS | 15.0+ (Sequoia) |
| Chip | Apple Silicon (M1 or later) |
| Xcode | Required for building and running your app |
The Haptix daemon (haptix-server) runs as a launchd service and starts the MCP server on localhost:4278. The menu bar app provides the UI, screen capture, and session recording.
HaptixKit (iOS SDK)
| Requirement | Minimum |
|---|---|
| iOS | 16.0+ |
| iPadOS | 16.0+ |
| Swift | 5.9+ |
| Distribution | Swift Package Manager |
The SDK is distributed as a pre-built XCFramework via Swift Package Manager. It listens on a fixed port (4279) for connections over USB.
Supported devices
Physical devices
Any iPhone or iPad running iOS/iPadOS 16.0 or later. This includes:
- iPhone 8 and later
- iPad (6th generation) and later
- iPad Air (3rd generation) and later
- iPad Pro (all models with iOS 16 support)
- iPad mini (5th generation) and later
Physical devices require two settings enabled:
- Developer Mode — Settings → Privacy & Security → Developer Mode
- UI Automation — Settings → Developer → Enable UI Automation
Simulators
All iOS and iPadOS Simulators that ship with Xcode are supported. Simulators do not require Developer Mode or UI Automation settings.
Connection
Haptix uses USB only for device communication. Connect your iPhone or iPad to your Mac with a USB cable.
| Component | Protocol | Details |
|---|---|---|
| Device discovery | USB (devicectl) | Automatic detection of USB-connected devices |
| Device communication | WebSocket | Over USB, fixed port 4279 on device |
| Agent connection | Streamable HTTP | localhost:4278/mcp (never leaves your machine) |
No network discovery, no Wi-Fi — all communication is over USB and localhost. Nothing leaves your machine.
Why USB?
USB unlocks the live screen stream — a real-time video feed from your device used for compositor screenshots. It's also more reliable and lower-latency than Wi-Fi for all device interactions.
Supported AI agents
Any MCP-capable agent works with Haptix. Tested and documented:
| Agent | Config format |
|---|---|
| Cursor | .cursor/mcp.json |
| Claude Code | CLI command |
| VS Code | .vscode/mcp.json |
| Windsurf | mcp_config.json |
| Claude Desktop | claude_desktop_config.json |
| Codex | CLI command |
| OpenCode | opencode.json |
See MCP Setup for the exact config for each agent.
Licensing
| License type | Updates | Use |
|---|---|---|
| Standard | 1 year from purchase | Perpetual — app keeps working at last entitled version |
| Lifetime | Forever | Perpetual |
- 1 license = 1 seat = 1 developer = 2 machines (e.g. laptop + desktop)
- Team licenses scale by seats: 10 seats = 10 developers = 20 machines
- Machine limit enforced at activation time
- 7-day money-back guarantee
Purchase at haptix.dev.