CoincideFeature · Coming soon
Coincide Remote for iPhone and iPad
Coincide Remote is the companion app that lets you follow and steer the agents on your Mac from your iPhone or iPad. It isn’t released yet. This page describes how it’s being built, so you know what to expect and how it handles your data.
Not available yet. Coincide Remote isn’t on the App Store or TestFlight, and there’s no release date. Coincide for Mac 0.1.0 works fully on its own. Follow @apoorvdarshan or join the Discord to hear when it ships. Details below may change before release.
What it’s for
Agents in Coincide often run for minutes or hours, in the background agent host, while you’re away from the desk. Coincide Remote puts those threads in your pocket. A paired device can see and control much of what Coincide on that Mac can:
- projects, threads and chats, with their messages and attachments, and new messages to your agents;
- answering an agent that’s waiting for approval or asking a question;
- diffs and git actions, scheduled tasks, bots, usage and settings;
- photos and files you attach on the phone, which go to your Mac and, when you send them, to the agent’s provider;
- dictation with Apple’s speech recognition on the device.
It’s being built to match the Mac app’s look and its 19 languages.
How it connects
There’s no Coincide server, relay or account in between. Your iPhone or iPad connects straight to Coincide on your Mac:
- Over your own network: on the same Wi-Fi or local network, the Mac announces itself with Bonjour, under your Mac’s name.
- Over Tailscale: away from home, the phone reaches the Mac through your own Tailscale network.
- Encrypted: the connection uses TLS 1.3, and the phone pins your Mac’s certificate when you pair, so it only talks to that Mac.
- Limited to private addresses: the Mac accepts connections only from local, private and Tailscale addresses.
Coincide has to be open on the Mac for the phone to connect.
Pairing
On the Mac, the switch lives in Settings › General › Coincide Remote (“Allow Coincide Remote”), and it’s off until you turn it on. Choose Pair iPhone or iPad… and the Mac shows a one-time pairing code that expires after five minutes; you scan it with the app.
The phone keeps a random token in its Keychain, and the Mac keeps only a hash of it. The same pane lists paired devices with when they last connected, lets you revoke any of them, and can reset the certificate, which forgets every paired device.
Notifications
With Coincide Remote in use and the Mac idle, Coincide sends its notifications (a turn finished, an agent needs you) to the iPhone or iPad instead of the Mac, never to both, and seeing a thread anywhere clears them everywhere. Notifications covers how this works on the Mac.
Lock-screen alerts are optional and off by default. When you turn on “Notify this iPhone when it’s locked”, the Mac writes a short alert (the thread’s title, what happened and a detail line of up to 120 characters) to your own private iCloud database, and Apple delivers it as a push notification. Coincide deletes each alert once you’ve seen its thread. This needs a Mac build signed for iCloud; the builds published on GitHub for 0.1.0 leave that entitlement out, so lock-screen alerts aren’t available with them.
Permissions on the phone
Camera (to scan the pairing code and take photos you attach), photo library (photos you pick or save), microphone and speech recognition (dictation), and local network (to find and reach your Mac).
Privacy
Everything goes between your devices, and to your agents’ providers only when you send a message. The privacy policy already covers Coincide Remote, including what Apple may share if you install it through TestFlight or the App Store.