Skip to content

A tiny friend in your Mac's notch and on your iPhone that keeps an eye on your AI coding agents: Claude Code, Codex, Cursor, Gemini CLI, Antigravity and more. Approve from the notch or your Lock Screen.

README and site: Coucou on iPhone, App Store, complete 0.1.8 notes (#254)

Louis587f1db52c74
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 23431cdc..0fffb1d8 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,11 @@
- Allow or deny a permission from the iPhone: a notification with the command, Deny right from it, Allow behind Face ID. Your Mac only applies a decision meant for the exact request it is waiting on, and the request expires after 2 minutes. The iPhone keeps a history of your decisions (#220)
- Lock your Mac while an agent works and Mochi moves to your iPhone's Lock Screen and Dynamic Island, then comes back to the notch when you unlock. Turn it on under Settings → General → iPhone. It goes through a small relay that only sees the agent's name and state (#221)
- Mochi, the pills and the diff engine now live in a shared package used by both apps; nothing changes in the notch (#210)
+- The iPhone sees more of what your Mac sees: every service Mochi (GitHub, Stripe, Vercel, Resend, Cal.com, n8n, Notion) with its latest items, and the last turn of each session with its commands and diffs, all encrypted with your iCloud keys. No API key ever leaves the Mac (#224)
+- Send the next instruction to Claude Code from the iPhone (GitHub build, off by default): your Mac picks it up within 15 seconds and continues the session in its own folder (#224)
+- Answer Claude's questions from the iPhone: your Mac applies an answer only if it matches the question still waiting (#241)
+- The Live Activity counts the time since Mochi left, and shows Allow and Deny while a command waits for you (#232, #241)
+- A new coucou sound for Mochi's greeting (#241)
## 0.1.7 — October 4, 2026
diff --git a/README.md b/README.md
index abf6f8cd..bea44074 100644
--- a/README.md
+++ b/README.md
@@ -4,12 +4,13 @@
# Coucou
-**A tiny friend that lives in your Mac's notch — or at the top of your screen on Windows and Linux — and keeps an eye on your AI coding agent sessions.**
+**A tiny friend that lives in your Mac's notch — or at the top of your screen on Windows and Linux — and keeps an eye on your AI coding agent sessions. And now on your iPhone too.**
-Approve permissions, watch your agents work, drop a file, chat with Claude — all without leaving what you're doing.
+Approve permissions, watch your agents work, drop a file, chat with Claude — all without leaving what you're doing. Walk away from your Mac and Mochi follows you to your iPhone: Lock Screen, Dynamic Island, widgets, Siri.
[![Version](https://img.shields.io/github/v/release/Louis-CFM/coucou?filter=v*&label=version&color=0A84FF)](https://github.com/Louis-CFM/coucou/releases)
![macOS 15+](https://img.shields.io/badge/macOS-15%2B-black?logo=apple)
+![iOS 18+](https://img.shields.io/badge/iOS-18%2B-black?logo=apple)
![Windows 10/11](https://img.shields.io/badge/Windows-10%2F11-0078D4?logo=windows&logoColor=white)
![Linux](https://img.shields.io/badge/Linux-AppImage%20%7C%20deb%20%7C%20rpm-FCC624?logo=linux&logoColor=black)
![Swift 6](https://img.shields.io/badge/Swift-6-F05138?logo=swift&logoColor=white)
@@ -50,8 +51,23 @@ Meet **Mochi**: a soft little squircle with big eyes that pops out of your notch
- 🎭 **A real character** — idle breathing, blinks, eyes on a sphere that follow your mouse, emotes, 28 handcrafted sounds, a greeting on launch.
- 🫥 **Invisible when idle** — hides away when nothing is running, peeks out when you hover the notch (the top edge of the screen on Windows and Linux).
- 🖥️ **Any Mac, notch or not** — on an iMac, a Mac mini, or a MacBook with its lid closed on an external display, Mochi sits in a small bar at the top of the screen.
+- 📱 **Coucou on iPhone** — your sessions, approvals and services in your pocket, with Live Activities, widgets and Siri. See [Coucou on iPhone](#coucou-on-iphone).
- 🔒 **Private by design** — no telemetry, no account. Keys live in your macOS Keychain, Windows Credential Manager or Linux Secret Service (GNOME Keyring, KWallet). The app only talks to the services you plug in.
+## Coucou on iPhone
+
+The Mac app does the work; the iPhone app keeps you in the loop when you step away. It goes as far into the Apple ecosystem as a dev tool can:
+
+- 🏝️ **Live Activity and Dynamic Island** — lock your Mac while an agent works and Mochi moves to your iPhone's Lock Screen and Dynamic Island with the agent's state, then comes back to the notch when you unlock. **Allow** or **Deny** a permission right from the Lock Screen, without opening the app.
+- 🔔 **Notifications you can act on** — Allow, Review or Deny a permission, pick an answer to Claude's question, or reply to a finished agent, straight from the notification.
+- 🔐 **Face ID on every Allow** — nothing runs on your Mac without your explicit tap; your Mac only applies a decision meant for the exact request it is waiting on.
+- 💬 **Talk to your agents** — follow each session live (steps, diffs, the last turn), answer questions, and send the next instruction to your Mac by text or voice.
+- 🧩 **Widgets, Control Center, Siri and Shortcuts** — home and Lock Screen widgets, a Control Center control, ask Siri how your agents are doing or send Claude an instruction, in Siri and Shortcuts.
+- 🔎 **Spotlight and Focus** — find past turns in Spotlight; a Focus filter shows only the agents waiting for you.
+- 📊 **Your services up close** — GitHub, Vercel, Stripe, Cal.com, n8n, Notion, Resend: your Mac reads their APIs with the keys in its Keychain and the iPhone shows the figures and lists. Safe actions (re-run CI, redeploy, merge a PR, pause a workflow) behind Face ID; nothing that moves money or sends an email.
+- 🫧 **Liquid Glass, native to the bone** — SwiftUI, tabs, zoom transitions, context menus, swipe actions, alternate icons, Mochi at 120 Hz.
+- 🔒 **Through your own iCloud** — sessions sync through your private CloudKit database; project names, commands and questions are encrypted with your iCloud keys. No Coucou server sees your projects, commands or keys. Turn it on in the Mac app: Settings → General → iPhone.
+
<table>
<tr>
<td><img src="docs/media/claude-code.png" alt="Claude Code session"></td>
@@ -83,6 +99,12 @@ Windows 0.1.1 and Linux 0.1.1 (beta) are in Releases under the `windows-v*` and
## Install
+### App Store
+
+Coucou is coming to the **Mac App Store** and the **iPhone App Store**: one click to install, automatic updates, and the iPhone app pairs with your Mac through your iCloud account, with nothing to configure. The links will be here as soon as Apple publishes them.
+
+The App Store build of the Mac app runs in Apple's sandbox, so a few features stay in the GitHub build: Claude plan usage, the Apple Music pill and attaching the front window to the chat.
+
### Download for macOS
1. Grab the latest `Coucou.zip` from [Releases](https://github.com/Louis-CFM/coucou/releases).
@@ -195,6 +217,12 @@ If Coucou isn't running, the hook exits immediately: **Claude Code is never bloc
The macOS app is native Swift 6 / SwiftUI / AppKit with **zero third-party dependencies**.
+**iPhone**
+
+- A native SwiftUI app sharing Mochi's engine, the pills and the diff engine with the Mac through `CoucouKit`.
+- The Mac publishes sessions, turns and services to a private CloudKit zone in your iCloud (sensitive fields encrypted with your iCloud keys); the iPhone reads them and writes back decisions, answers and instructions, which the Mac only applies when they match what it is waiting on.
+- Live Activities are started and updated by APNs pushes through [`relay/`](relay/), a stateless Cloudflare Worker that holds the APNs key and only sees the agent's name and state.
+
**Windows**
- A [Tauri 2](https://tauri.app) app (Rust + TypeScript): the island is a transparent, always-on-top window that never steals focus, Mochi is drawn in Canvas 2D with the same shapes, timings and sounds as on the Mac.
diff --git a/docs/index.html b/docs/index.html
index 57aed639..15ec7d9d 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -4,10 +4,22 @@
<nav><a href="index.html" class="on">Home</a><a href="support.html">Support</a><a href="privacy.html">Privacy</a><a href="terms.html">Terms</a><a href="legal.html">Legal</a></nav></header>
<div class="hero">
<h1>A tiny friend that lives in your notch</h1>
-<p class="meta" style="font-size:17px">Coucou watches your AI coding agents — Claude Code, Codex, Cursor, Gemini CLI, Antigravity and more — lets you approve Claude Code and Codex requests from the notch, chat with Anthropic, Google AI or OpenAI, and keeps an eye on Stripe, GitHub, Vercel, n8n and more. Free and open source.</p>
+<p class="meta" style="font-size:17px">Coucou watches your AI coding agents — Claude Code, Codex, Cursor, Gemini CLI, Antigravity and more — lets you approve Claude Code and Codex requests from the notch, chat with Anthropic, Google AI or OpenAI, keeps an eye on Stripe, GitHub, Vercel, n8n and more, and follows you to your iPhone. Free and open source.</p>
<a class="btn" href="https://github.com/Louis-CFM/coucou/releases/latest">Download for Mac</a><a class="btn ghost" href="https://github.com/Louis-CFM/coucou">View on GitHub</a>
<img class="demo" src="media/demo.gif" alt="Coucou in action">
</div>
+<h2>Now on iPhone</h2>
+<p>Step away from your Mac and Mochi follows you. The iPhone app goes as far into the Apple ecosystem as a dev tool can:</p>
+<ul>
+<li><b>Live Activity and Dynamic Island:</b> lock your Mac while an agent works and Mochi moves to your Lock Screen. Allow or Deny a permission right from there.</li>
+<li><b>Notifications you can act on:</b> Allow, Deny, pick an answer to Claude’s question, or reply to a finished agent.</li>
+<li><b>Face ID on every Allow:</b> nothing runs on your Mac without your explicit tap.</li>
+<li><b>Talk to your agents:</b> follow each session live, read the diffs, send the next instruction by text or voice.</li>
+<li><b>Widgets, Control Center, Siri, Shortcuts, Spotlight and Focus filters.</b></li>
+<li><b>Your services up close:</b> GitHub, Vercel, Stripe, Cal.com, n8n, Notion and Resend, with safe actions like re-running CI or redeploying.</li>
+<li><b>Through your own iCloud:</b> no Coucou server sees your projects, commands or keys.</li>
+</ul>
+<p class="meta">Coming to the Mac App Store and the App Store: one click to install, automatic updates, and the iPhone pairs with your Mac through iCloud. Until then, download the Mac app from GitHub.</p>
<div class="card"><b>Private by design.</b> No account, no analytics, no tracking. Your keys stay in your Keychain, Windows Credential Manager or the Linux Secret Service. <a href="privacy.html">Read the privacy policy</a>.</div>
<p class="meta">Requires macOS 15 or later. No notch? Mochi sits in a small bar at the top of the screen. The Windows download is paused for now: Microsoft Defender wrongly flags the unsigned installer, and it will come back once that’s fixed. Windows users can <a href="https://github.com/Louis-CFM/coucou/tree/main/windows#build-it-yourself">build it from source</a>. Linux: a beta is out (AppImage, .deb, .rpm), <a href="https://github.com/Louis-CFM/coucou/releases/tag/linux-v0.1.1">download it here</a>.</p>
<footer>© 2026 Louis Raillé · Coucou is free and open source (MIT) · <a href="https://github.com/Louis-CFM/coucou">GitHub</a> · <a href="privacy.html">Privacy</a> · <a href="terms.html">Terms</a> · <a href="legal.html">Legal notice</a></footer></div></body></html>