Get started
Install Coral, grant the permissions it asks for, and pair your iPhone.
What you need
- A Mac with macOS 14 Sonoma or later, Apple silicon or Intel. Macs without a notch get the same island at the top of the screen.
- At least one coding agent: Claude Code, Codex (the CLI or the Codex app), the GitHub Copilot CLI, OpenCode or the Grok CLI.
- For the iPhone app: an iPhone with Face ID.
Install
Coral isn't on the Mac App Store. It needs terminal access the App Store sandbox doesn't allow, so you'll download it from this site once it's out.
When you first open Coral, it looks for the agents, terminals and editors on your Mac and lists only what it found. Each agent gets one row that connects it (for Claude Code, its hooks; for OpenCode, one plugin file), and the row says exactly which files change and where the backups go. When Coral updates, it keeps its own hooks current, but it never replaces one you changed: a hook you wrapped or edited stays as you left it, and Settings → Agents tells you once, with a way to put Coral's back. To take Coral's hooks out, choose Agent Hooks in the island menu, then Remove Claude Code Hooks (or the Codex, Copilot or OpenCode item). Your own hooks stay, and Coral backs up the file first.
The Grok CLI has no row of its own. It runs Claude Code's hooks, so once Claude Code is connected, Grok sessions show up with their own name and logo. You can message a Grok session, send it screenshots and stop it from Coral. Answer its permission questions in its terminal: Grok doesn't let a hook approve them.
Not ready? Choose Later (or press Esc) and setup tucks back into the notch, with a small coral dot on the island until it's done. Click the island to pick up where you left off. Setup also reopens the next time Coral starts, up to twice, and Welcome Screen… in the island's right-click menu starts it over at any time.
Mac permissions
Coral asks for every permission during setup, so a system prompt never interrupts you later. Each one has its own Allow button that opens the real macOS prompt. You can skip any of them; the feature that needs it stays off, and Settings → Permissions shows the status of each one at any time.
| Permission | Why Coral asks |
|---|---|
| Accessibility | For the hold-to-talk key, to find your terminal windows and deliver your answers there, and to act in apps when you use Your Mac from your iPhone. |
| Screen Recording | To send screenshots to your agents, and so Coral can see the screen during a Your Mac turn. |
| Screen capture check | macOS asks once more before Coral captures the screen itself. Coral takes one test capture while you're at your Mac, so you choose Allow now and the question never stops a Your Mac turn while you're away. |
| Microphone and Speech Recognition | To talk to Coral while you hold Right Option. Your speech is turned into text on your Mac. |
| Notifications | So you hear about agents when the island is hidden. |
| Automation (Terminal, iTerm2, Ghostty) | To bring the right terminal tab forward. Asked only for the terminals you have. |
| Editor helper (optional) | VS Code, Cursor and Windsurf: so Show terminal can open the exact terminal tab. Asked once, added only if you say yes. Tabs only, no network. |
Accessibility and Screen Recording take effect once you approve them in System Settings → Privacy & Security. Coral notices the change and updates its check.
The three that Your Mac needs (Accessibility, Screen Recording and the screen capture check) have their own optional setup step. Coral shows it again when you turn on Work while locked if one is missing, and Set Up… in the iPhone window opens it any time.
If you skipped one and later use the feature that needs it, Coral tells you in the island and opens the right pane of System Settings. It doesn't fail silently.
Pair your iPhone
Pairing links your iPhone to one Mac. There's no account, name or email involved.
Coral for iPhone is in beta on TestFlight: get it here on your iPhone. It's free; TestFlight asks you to install Apple's TestFlight app first.
- On the Mac, choose iPhone… from Coral's menu, then Pair iPhone…. Coral shows a QR code.
- Open Coral on your iPhone and scan the code. The code works once and expires after 5 minutes.
- Both devices show the same 6-digit code. Check that they match before you continue.
Your iPhone is now listed under Paired devices in the iPhone window. To unpair, remove it there, or unpair from the iPhone. Removing a phone deletes its key, and it stops getting updates from that Mac.
After an update, a What's new card shows once on your iPhone. Settings › About has What's new again, and Rate Coral.
If someone tried to swap in their own keys during pairing, the two 6-digit codes would differ. That's why you compare them.