Share phones from Appeeky Desktop
- Open Appeeky Desktop and sign in with your Appeeky account.
- Go to Settings → Phones.
- Turn on Share phones with Appeeky.
Open phones and approvals opens the Phones page of the web dashboard.
Phones belong to the account that is signed in to Appeeky Desktop. API keys and MCP sessions of the same account can use them. Other accounts can’t.
Android
1
Turn on USB debugging
On the phone, open Developer options and turn on USB debugging.
2
Connect it by USB
Connect the phone to the Mac with a cable and tap Allow on the phone when it asks.
3
Keep it unlocked
A locked screen stops the agent.
adb. It looks for it in the Android SDK (~/Library/Android/sdk/platform-tools, or the folder set in ANDROID_HOME or ANDROID_SDK_ROOT) and then on your PATH. If adb is not installed, no Android phone is found.
iPhone
1
Install Xcode and sign in
Install Xcode on the Mac. In Xcode, open Settings → Accounts, sign in with your Apple ID, then choose Manage Certificates → + → Apple Development. A free personal team works.
2
Turn on Developer Mode
On the iPhone, open Settings → Privacy & Security → Developer Mode and turn it on.
3
Connect it by cable
Connect the iPhone to the Mac, unlock it and tap Trust when it asks.
4
Wait for the helper app
Appeeky Desktop builds a small helper app, WebDriverAgent, with Xcode and starts it on the iPhone. The Phone page shows Preparing your iPhone with the current step. The first time takes a few minutes. Later starts are faster because the build is reused.
5
Trust the developer on the phone
If the helper does not start on the first run, open Settings → General → VPN & Device Management on the iPhone and trust your developer certificate.
Forwarding the connection to the iPhone uses the
iproxy tool. If it is missing, the setup log says so and tells you to install it with brew install libimobiledevice.What works on each platform
Check the connection
Open/dashboard/phones. The Connected section lists each Mac with an online badge, how long it has been connected, and its phones with their platform.
- No phones connected means no Mac is sharing. Open Appeeky Desktop and check Settings → Phones.
- No phones on this Mac right now means the Mac is online but found no phone. Setup problems are listed under the Mac, for example
iOS: Alex's iPhone: Developer Mode is off. Turn it on: Settings > Privacy & Security > Developer Mode.

