CoralDocs

Features

What Coral does for free, and what Pro adds.

New here? Start with Get started. For the overview, see Features. For prices, see Pricing.

Free

  • Every agent in the notch. The one that has waited longest comes first. The list groups agents into Needs you, Done, Working and Idle, on your Mac and your iPhone. Done agents show how long they've waited for you. Click a group's header to fold it. Idle starts folded.
  • Projects. Agents group by the project they work in: the git repo around their folder, so hawkins/web and hawkins/api sit together and a worktree joins its repo. Needs you always stays on top, across every project. Each project shows what's working, done and idle, and a + to start an agent right there. On your Mac, press N to start one in the selected project without leaving the notch. On your iPhone, tap a project to open it, and hold it to pin, rename, fold finished agents or hide it. Prefer the old view? Switch to By status in the list's menu.
  • Pick a model. When you start an agent, pick its model next to the agent: Opus, Sonnet, Fable or any other model that agent offers. The list is the agent's own, the same one its /model shows, so new models appear by themselves. Default keeps the agent's own setting. Coral remembers your last pick for each agent: per project on your Mac, per Mac on your iPhone, where the Model row sits under Agent. Works with Claude Code, the Codex CLI and OpenCode.
  • Answer with one key. Press 1, 2 or 3. ⌘Z takes it back within two seconds. You see what the agent wrote just before asking, every option in full, and any sketch it drew for an option.
  • Approve plans. When Claude Code finishes a plan, the card asks "Ready to code?" with the plan below it. Press space to read it all, or O to open the plan file in your editor. You get the same choices as the terminal: 1 approves and switches to auto mode (auto-accept edits when your Claude Code has no auto mode), 2 approves and you review each edit. Type in the reply field to send Claude back to planning with your notes. On your iPhone, approving needs Face ID. A plan too long to show there in full, or one that mentions secrets or destructive commands, can only be approved on your Mac.
  • Say it instead. Hold ⌥ and talk. Coral works out which agent should get it.
  • When a task is done. A one-line summary, the time it took, and the tokens it used. On an API key or extra usage you see real dollars instead. D for the diff, P for a pull request.
  • Your own buttons. Run tests, Ship it, Deploy preview: a script or an Apple Shortcut, one key away.
  • Stuck alerts. Coral flags an agent that stops making progress or repeats the same error.
  • Screenshots. Paste or drag an image onto the island, and it goes to that agent with your reply.
  • Nothing you type is lost. Started a message and went back? It waits for you, photos included. On your iPhone that's every box: Ask, an agent's chat, Your Mac, a new agent and answers. On your Mac, replies, notes and a new agent's first message. Drafts stay on the device, and go when you send them, after 7 days on your iPhone, or when you unpair that Mac.
  • Sounds and focus. One soft chime when an agent asks. Silent while you focus.
  • History. The last 24 hours, so you can pick up where you left off.
  • Usage. Press U for what's left of each plan: Claude Code, Codex, Copilot and Grok, read from each tool's own account. When a limit will hit 0% before it resets at your pace so far, a line says when, like "Runs out Mon 23:00". Hover any limit to see its line anyway.
  • Restore agents. Restarted your Mac? Coral offers back the agents that were open, like Chrome restores tabs. Each opens where it ran. Missed it? Recently closed waits at the top of History, or choose Reopen Closed Agents in the island menu.
  • Hand off. Move an agent to a fresh session in one click, any time. The agent writes a short note (done, decisions, open issues, next step). Check it, pick Claude Code, Codex or OpenCode, and press Start new session. It opens in a new tab, in the same terminal and folder, with the note as the first message. History keeps both sessions as one chain. Select an agent and press ⇧H. Your own /handoff command works too. Free on your Mac. On your iPhone it is Pro.
  • Time saved. The top of History shows what Coral saved you this month, for example "6 h 20 min" over "47 answers · usually within 10 sec". See Time saved.
  • A companion. Pick one of nine animals, or none. It reacts when an agent asks or finishes, and your iPhone shows the same one.
  • When an agent finishes. On your Mac, a banner tells you when an agent finishes its turn, but only when you can't see the island: menu-bar mode, a locked or sleeping screen, or full screen. It stays quiet in Focus mode. It shows what failed, or a short summary of what the agent did. Turn it off in the island menu with Notify When Agents Finish. On your iPhone, a push arrives when an agent finishes while you're away from your Mac. It works for Claude Code, Codex, Copilot, OpenCode, Grok and agents on your servers.
  • Show terminal. One key or tap lands on the exact tab, in tmux (a detached session gets a note), Ghostty, iTerm2, Terminal, WezTerm, kitty, Alacritty and the terminals in VS Code, Cursor and Windsurf. In editors Coral finds the window by folder; the optional editor helper, added only if you say yes, finds the exact tab. When Coral can't find the window, it says so. WezTerm and Alacritty need the Accessibility permission.
  • Your iPhone link. When your Mac can't reach your iPhone, the island menu and the iPhone window say "Can't reach your iPhone" and show the link status.

Pro

  • Baton. For long and overnight tasks. It works on a new branch, commits before every handoff, stops before it eats your Claude week (or at your spend cap on an API key) and runs only commands you've allowed.
  • Approval rules. Approve the same kind of request automatically. Never for destructive commands like rm -rf or a force push, commands that run scripts (npm run, go run), paths outside the project, or edits to build files like package.json.
  • Brief. A short summary for every agent.
  • Full History and search. Find any closed session by what it was doing, what you asked or the files it changed, including sessions from before you installed Coral (Claude Code and Codex), and pick up where you left off.
  • Stay Awake. Your Mac stays up while agents work, then sleeps as usual.
  • Watchdog. Coral checks that an agent did everything you asked. See Watchdog.

Time saved

Coral compares each answer with how long you usually wait without it. That usual wait is your own: the median wait when you answered a permission or a question straight in the terminal, over the last 30 days, from at least 3 such answers. A question with no number of its own uses the permission one. Until there's a number to compare with, History shows only the count of answers.

  • Saved this month. For every prompt you answer through Coral (the island, a key or your iPhone), your usual wait minus the wait it actually had. A rule's instant answer (Pro) saves the whole usual wait.
  • On Free. The Mac shows "3 h 10 min lost this week to waits Pro handles", from 15 minutes. It lists real events from the last 7 days: prompts an approval rule would have answered, overnight runs (22:00 to 7:00) that waited 10 minutes or more on a question, and times your Mac slept while an agent worked. Not now hides it for 7 days. The License window shows the same. Never on your iPhone.
  • Monday. At the first wake on Monday, the notch shows "Saved 4 h 05 min last week" when it was 10 minutes or more. Turn it off with Weekly time saved in Settings.

It all stays on your Mac. See Privacy and security.

Watchdog

Pro, on your Mac. Agents often finish two of three asks and say "done". Watchdog catches that.

Send an agent a prompt with two or more asks, like "Add the dark mode toggle, update the settings copy, and add the dark icons." The island offers once: Make sure all 3 get done? Pick Not now, Always or Watch. Coral finds the asks on your Mac, without a model.

  • Watch. Each time the agent stops, Coral checks every ask against the agent's last message and the files it changed. It's one short call to Claude Haiku through your own Claude Code login, the same as Briefs.
  • A nudge. If an ask isn't done, Coral sends the agent a short message: "Coral, checking your asks: you haven't done 3 yet (add the dark icons). Continue." At most 2 nudges per prompt.
  • The done card. It lists your asks with checks. If something is still missing, it says what, in amber, with Send it back (S).
  • Always. Watches every prompt with several asks. Turn it off from the island's menu. Prompts you didn't choose to watch are never sent to a model.
  • Safe. Coral never nudges past a step that's waiting for your approval. You can Stop watching any time.
  • On your iPhone, the offer shows in the agent's thread with Watch and Not now, the brief line counts "2 of 3 done", and a nudge shows in the live stream as a message from Coral. When something is still missing, the done notification has Send it back.

See Privacy and security.

iPhone (beta)

On TestFlight: get it here on your iPhone.

  • Free: alerts when an agent needs you or finishes, Live Activity, every agent's conversation to read, and whether your Mac is awake, asleep or offline. Apple Watch shows the alerts too. You can also answer, message agents and start agents from your iPhone. What you send waits on your Mac until you press Return there.
  • Usage. The Report tab always opens on what's left of each plan: the session and the week for Claude Code, Codex and the rest, and when each resets. A bar turns amber below 25% and red below 10%, like the notch. After time away, an amber segment shows what the week used while you were gone. Free.
  • Pro: what you send from your iPhone reaches the agent right away. That includes answers, messages, new agents, Ask and Your Mac. You also see when each answer is delivered.

Photos and voice

Tap + next to the message box on an agent's screen to take a photo, choose up to 5, or attach your last screenshot. A photo can go without text. While the agent works, photos go with Tell. Tap the mic to talk: your words appear in the box for you to check, and nothing sends until you do. Talking is turned into text on your iPhone.

You can talk in every box you type in, Ask Coral and Your Mac included, and add photos to a question's reply or a new agent's first message.

A Tell message waits on your Mac until the agent's next step. Until it's read, tap Undo under it: it comes off your Mac and its text and photos go back in the box.

In Warp, Coral can't type for you, so a message from your iPhone reaches Claude Code marked as from another session. The agent takes it as a teammate's request: it does the safe work and waits for you before anything outward-facing, like a push. To give the go-ahead from your iPhone, answer the agent's permission prompt. In Terminal, iTerm2, Ghostty, tmux, WezTerm and kitty, Coral types the message in, so it arrives as yours.

Ask can look things up

Ask answers from what Coral already sees: briefs, the recent conversation and the queue. Turn on Ask can look things up and, for a Claude Code agent, Coral can also read the project's files and its Claude memory to find things like links. Links in answers show as tappable chips on your iPhone.

It's off by default. Find it on your Mac, in Coral's iPhone window. A screen explains it before it turns on.

  • Read-only. Coral opens a copy of the session. The copy can read files. It can't run commands, edit files, browse the web or use MCP tools, and nothing is saved.
  • The agent never sees it. Your question goes to the copy, not to the agent.
  • It uses your plan. What it reads goes to Anthropic through your Claude Code login, and each question uses some of your Claude plan.
  • Other agents. Codex and the rest keep the quick answer.

See Privacy and security.

Servers

  • Pro: agents on your SSH servers and dev containers show up in the notch like local ones, and can reach your iPhone while your Mac sleeps. See Servers.