Mac Companion
Connect your iPhone or iPad to a compatible Mac through MadoHub Cloud or encrypted local pairing.
Companion brings a Mac's MadoHub canvas to your iPhone or iPad. Follow desktop Agent status, read terminal output, and send supported actions away from the keyboard. Your mobile Agent workspace can also run independently.
The Mac must run a compatible MadoHub version with Companion enabled. Keep the Mac awake, connected, and MadoHub open while using it remotely. Available actions depend on the connected Mac.
Connect through MadoHub Cloud
- Sign in to the same MadoHub account on both devices.
- On the Mac, enable Companion in Settings → General and keep the app open.
- On iOS, enable Connect signed-in Macs automatically in Settings → Mac Connection. Select an online Mac from the list if needed.
- Wait for Connected before using the desktop view and controls.
MadoHub Cloud relays device state and actions, so devices can be on different networks. Both need internet. From iOS 1.1, automatic discovery is off when no preference has been saved; existing choices are preserved.
In iOS 1.1.2, select the Mac you want to control from the device list. MadoHub remembers the selection for later cloud connections. If that Mac goes offline, choose another online Mac explicitly; the app does not silently switch targets. A Mac that registers a new connection may need to be selected again.
Pair on the local network
- Connect both devices to the same Wi-Fi and display the Mac's Companion QR code in Settings → General.
- On iOS, use Settings → Mac Connection → Scan QR Code, or paste the complete pairing link into the local connection field.
- If the Mac requests approval, check the account and device before allowing it.
- Wait for confirmation of a local encrypted connection.
Use the complete code generated by the Mac. It contains the identity information required for encrypted pairing; an address and port alone are not enough. Replace old protocol links with a fresh code. Camera permission is used when you choose QR scanning.
Work with the connected Mac
Open a desktop tile to read terminal details and send text or supported key actions. Check the target and current prompt before approving or stopping work. Actions under the Mac's name can create a desktop terminal or workspace and run available desktop Flows.
Mobile Agents and mirrored desktop tiles continue their own tasks. Connecting does not copy your entire local mobile history to the Mac. Use the Mac for desktop layout changes not offered on the phone.
In iOS 1.1.2, wide terminal output scrolls horizontally. Turn on automatic line wrapping when you prefer long lines to fit the screen. Long streaming updates automatically keep latest lines visible.
Fix connection problems
| Symptom | What to check |
|---|---|
| No online Mac | Same account, Companion enabled, Mac awake, MadoHub open, network available |
| Cloud connection keeps retrying | Internet on both devices; use Try Again, or try local pairing on the same Wi-Fi |
| Local pairing fails | Local network permission, Wi-Fi device isolation, VPN settings, a fresh complete QR code |
| Protocol or identity error | Update both clients to compatible versions and pair with the current Mac's code |
| No camera access | Allow QR scanning or paste the link instead |
For mobile-only use, turn off automatic Mac connection. In an older iOS version, reopen the app if a discovery warning remains after disabling it.
Disconnect and manage trusted devices
Turning off automatic connection stops cloud discovery and automatic cloud connection. Disconnect Local Connection ends the local connection. Forget This Mac only removes pairing saved on this phone; it does not revoke authorization on the Mac. To revoke a trusted device, remove it from the Mac's trusted-device list.
Privacy and support
Local pairing uses encryption and checks the Mac identity from the pairing code. Cloud connection passes desktop state, terminal excerpts, and actions through MadoHub Cloud. See the Privacy Policy for processing and retention.
If the issue persists, contact [email protected] with both app versions and the error. Remove private output from screenshots and never send passwords or pairing links.