Need a hand?
Xtend is built and maintained by one person. Reach out directly, most questions are answered within a day or two.
Common topics
- Setup & pairing, sign in with the same Apple ID on both your iPhone and your Mac. The iPhone finds the Mac registered under your account, so pairing works the same on your Wi-Fi and off it, remote access is not the paid feature. On the same Wi-Fi the two connect directly to each other whenever they can.
- Account & device security, every signaling and TURN request is authenticated with a Sign-in-with-Apple-backed session token. Only the device signed in to your Apple ID can join your session. WebRTC media is end-to-end encrypted (DTLS-SRTP); even the TURN relay sees encrypted bytes only.
- Mac permission prompts. Screen Recording and Accessibility are required for the Mac companion to capture the simulator and forward touch events.
- Command approvals. Xtend does not decide what your agent is allowed to run. Your agent's own permission rules do, reading the same
~/.claude/settings.jsonyou already use, so a command behaves on the phone exactly as it would in Terminal on that Mac. Anything not already allowed comes to your phone as an approval; when you allow it there, the decision is written to the project's.claude/settings.local.json, so it applies at your desk too. If you are approving more than you expect, check that file and your global settings. - Connection drops, most often caused by Wi-Fi roaming or VPNs. The app retries automatically. Also check that no other device is holding the session: for now Xtend supports one active connection at a time, so make sure your Mac isn't paired with a second iPhone and your iPhone isn't connected to another Mac.
- Build / scheme detection, the Mac runs
xcodebuild -liston your.xcodeproj; if no schemes appear, open the project in Xcode at least once first. - Terminal session issues, sessions live as long as the Mac companion is running; quitting the menu-bar app ends them.
When you email
Include your iOS & macOS version, the build numbers from each app (visible in the menu bar app's About panel), and a short description of what you tried. The more detail, the faster a fix lands. We aim to respond within 2 business days.
Bug report template
Copy this into your email, it speeds up the back-and-forth:
**What happened** … **What you expected** … **Steps to reproduce** 1. … 2. … 3. … **Devices** - iPhone model + iOS version: - Mac model + macOS version: - Xtend iOS build: - Xtend Host macOS build: **Network** - Same Wi-Fi? (yes/no) - VPN active? (yes/no) **Logs / screenshots** (attach if available)
System requirements
iOS 18.2 or later · macOS 15.2 or later · Xcode 16.2 or later.
← Back to Xtend