Your Mac from your iPhone

Your Mac is a chat on your iPhone with your Mac. You write what you want done, for example "check the sign-up form in Simulator", and Coral does it in the Mac's apps: it looks at the screen, clicks and types, and tells you what happened. On Free, a task you send from your iPhone waits on your Mac until you press Return there. With Pro it starts right away.

Start it from New agent on the iPhone and choose Your Mac. It needs Claude Code on your Mac, the Accessibility and Screen Recording permissions, and the screen capture check (see Get started).

Before each turn, and before it ever unlocks your Mac, Coral checks these and takes a test capture. If one is missing, your iPhone says so, for example "Not sent: Coral needs Screen Recording on your Mac. Open Coral on your Mac to allow it." If macOS asks about Coral's screen capture during a turn, the turn stops and your iPhone says "macOS is asking you to allow screen recording for Coral on your Mac." Coral never answers that question itself.

How a turn worksCopy Anchor Link

Each message you send starts a turn.

1. Coral runs Claude on your own Claude plan. The model only gets Coral's screen tools: no shell, no files, no web, and none of your Claude Code settings or hooks.
2. The model looks at the app first: a screenshot of its windows and a numbered list of its buttons, fields and menus. It acts on those, and looks again after acting.
3. The first time a chat wants to use an app, the turn waits for your approval on the iPhone (see Approvals).
4. When the turn ends, your iPhone shows Claude's reply and the last screenshot.

Your iPhone shows the latest step while it works. Tap Show screen to see the screen now. A message you send during a turn joins it at the next step.

One chat runs at a time. Its history carries across turns, so you can follow up. A turn stops after 80 actions or 15 minutes of running time. A chat ends after 30 minutes without a turn, or after 3 hours in all.

What Coral never doesCopy Anchor Link

These rules run in Coral's code before every action. They don't depend on the model following instructions.

• Never types into a password field. It can't read password fields either; they're listed without their value.
• Never touches System Settings, password apps or security dialogs. That includes Keychain Access, Passwords, password managers, the login window, Disk Utility and installers.
• Never uses terminals, because one wrong click there can run a command. The same goes for apps that run other things: Finder, the Dock, Spotlight, launchers like Raycast and Alfred, Script Editor, Automator, Shortcuts, other AI agents and virtual machines.
• Only clicks in code editors and Xcode. No typing, no menus, and Coral empties the clipboard first so nothing can be pasted there.
• Stays off sensitive web pages: browser settings and extensions, local files, and account, security and password sites (such as Google and Apple accounts or GitHub settings). If it can't read a page's address, it doesn't act there.
• Doesn't use global shortcuts. Key combos that use Control, Option or Fn, and switches like ⌘Space and ⌘Tab, are refused.

The model is also told, on top of these rules, never to pay or buy anything, and to stop right before sending, posting or deleting so you can confirm. Text on screen is treated as data, never as instructions.

Pause, Stop and EndCopy Anchor Link

• Touch your Mac and Coral pauses. Any key, click or trackpad movement from you pauses the turn at once. Your iPhone shows "Paused: you're using your Mac", with Resume and Stop. Resume waits until nobody has used the Mac for 3 seconds, then Coral looks again before it acts.
• Stop ends the current turn. The chat stays open, so you can send the next message.
• End closes the chat: the turn, Claude's process and the chat's app approvals. Starting a new chat ends the old one too.

On the Mac, a pill under the menu bar says "Coral is using your Mac", with the latest step and a Stop button.

Between turns, and while paused, Coral can't act at all: the Mac is yours again.

ApprovalsCopy Anchor Link

• Each app is approved once per chat. The first action in an app waits for a card on your iPhone: which app, whether Coral may click and type or only click, and a current screenshot. Approve with Face ID, or deny.
• No answer means no. After two minutes without an answer, the request is denied.
• Approvals end with the chat. A new chat starts with none.
• Every message and control is signed on your iPhone, so only your paired phone can start or steer a turn.

Your Mac needs to be unlocked for a turn to run, unless you turn on Work while locked.