Louis-CFM/coucou

---

Why

Some studios showed off gorgeous notch companions… and never let anyone use them. Coucou is the open version. Every line of code is open source under the MIT License: read it, fork it, learn from it. The Coucou name, Mochi and the sounds stay © Louis Raillé (see License).

Meet Mochi: a soft little squircle with big eyes that pops out of your notch, waves hello, follows your cursor with its eyes, gets annoyed when you poke it (and dizzy if you insist), and tells you the moment Claude Code needs you.

Coucou on the Mac: dictation, notes, one window

Since 0.4, Coucou has its own window and sits in the Dock. On the left, Flow — everything about your voice — and Notch, all the settings of the island. (macOS, GitHub build)

• 🎙️ Flow dictation — hold a key anywhere on the Mac (right ⌥ by default, or fn, right ⌘ or right ⌃), speak, let go: your words are pasted where you type, in any app. Two quick taps for hands-free, Esc to cancel, ⌃⌘V to paste the last one again. Your clipboard gets back what it held.
• 💊 The pill — a small see-through pill at the bottom of the screen (or on its left or right edge). Hover it for a toolbar: dictate, record a call, open Coucou. While you speak, Mochi listens and nine dots follow your voice.
• 🦜 Parakeet, offline — run NVIDIA's Parakeet on your Mac's Neural Engine through FluidAudio: more accurate, 25 languages, nothing leaves your Mac. One click to download (about 650 MB), Apple silicon only. Until then the Mac's own recognition is used.
• ✍️ Your words, your way — a dictionary of names Coucou always spells right, replacements, snippets (say a short phrase, paste a whole text), and an optional clean-up by Claude with your own key: as said, natural or polished, per app.
• 📝 Notetaker — click Record a call: Coucou records your microphone and what your Mac plays, no bot joins the call. Then you get the transcript person by person, a summary, the key points and the to-dos, written by Claude with your key or by Apple Intelligence on your Mac. The audio is deleted once the transcript is written. Tell the people in the call that you record.
• 📊 Statistics — words dictated, time saved, words per minute, days in a row and the apps you dictate in. Counted on your Mac, never sent anywhere.

Flow dictation and the Notetaker are on the Mac for now; Windows and Linux are next.

Features

• 🤖 Claude Code, Cursor, Codex, Gemini CLI, Antigravity, Copilot CLI, Muse Code, OpenCode, Amp, Hermes, Claude Desktop and other agents, live — see every session in your notch: what it reads, edits and runs, step by step. Tag a hook payload with coucou_agent to give any agent its own pill (see docs/AGENTS.md). Finished? Mochi does a happy little jump.
• See what Claude is editing, live in the notch: each file modification shows the file name and +N −M counts in the ticker, tap to read the full diff
• ✅ Approve and answer from the notch — Claude Code permission requests show up with Allow / Deny / Always; AskUserQuestion prompts show the choices right in the notch (single or multi-select, up to 4 questions). One click, or "Reply in terminal" to fall back to the CLI. Codex also gets Allow / Deny.
• 🧑‍💻 Jump to the right terminal — open the exact terminal window of a session (macOS).
• 💬 Chat with Claude, Gemini, OpenAI, DeepSeek, Qwen, Moonshot, or a local model (Ollama / LM Studio) — click the model name above the chat box to switch provider and pick a model. Cloud providers use your own API key; local providers connect to a server running on your Mac. No API key? Use your subscription: switch it on in Settings → Chat and the chat goes through the official terminal tool you already pay for, signed in with your own account — Claude Code, Antigravity CLI or Gemini CLI, Codex CLI (ChatGPT), Cursor CLI or GitHub Copilot CLI (GitHub build, Windows, Linux). (Gemini, OpenAI, DeepSeek, Qwen, Moonshot and local models: macOS)
• 📈 Portfolio pill (macOS) — track your crypto across 16 networks (Bitcoin, Ethereum, Solana, Polygon, BNB, Avalanche, Arbitrum, Optimism, Base, Dogecoin, Litecoin, TRON, XRP, Cardano, Cosmos, NEAR) and 5 exchanges (Binance, OKX, Bybit, Kraken, Coinbase) in the notch. Live balances, 7-day sparklines and 24-hour price change per holding. Read-only API keys for exchanges, public addresses for wallets — nothing leaves your Mac.
• 📊 Claude plan usage (macOS, GitHub build) — a small pill in the notch header shows your 5-hour and weekly Claude plan limits. Enable it from Settings → Agents → Plan usage. Pro and Max plans only.
• 📊 Codex plan usage (macOS, GitHub build) — a Codex pill next to it shows your Codex limits and how many free resets you have left, read from the Codex CLI. Turn it on in Settings → Agents → Plan usage.
• 📋 Declare the tools you use — open Settings → Active pills and pick your main workspace tool (VS Code, Cursor, Codex or Antigravity), then toggle up to 4 more: Gemini CLI, Anthropic, Google AI, OpenAI, Ollama, LM Studio and service integrations (macOS).
• ✉️ Mail in the notch (macOS GitHub build: Apple Mail; Windows: classic Outlook) — search every inbox and filter (Unread, Important, Today), read a message and act on it: reply, mark as read, important, junk. Coucou → Mail sorts new messages for you with your rules, banned words and VIPs, every action listed with Undo; nothing is ever deleted. Turn on Mail in the chat and the AI can prepare a plan — sorting, reply drafts, a mail merge with each recipient's page of a PDF — that runs only when you click Run.
• 📎 Drop a file on the notch — Mochi turns into a box and swallows it, then ask a question about it or send it by email (email: macOS, Mail.app).
• 🖥️ Mochi on the desktop — drag Mochi out of the island to set him loose on your desktop: he floats as a 120 pt companion, follows your cursor, wears his outfit, reacts to alerts by flying home and flying back, and comes back where you left him on next launch.
• 🪟 Drag Mochi onto any window — attach that window as context for Claude (macOS).
• 🔌 Integrations — Stripe payments, n8n workflows, GitHub (open PRs, reviews requested, CI status), Vercel deployments, Resend emails, Notion, Cal.com. Each one gets its own little colored Mochi.
• 🎵 Apple Music pill (macOS, GitHub build) — add the Apple Music pill in Settings → Active pills to see what's playing and control playback from the notch; Mochi dances while it plays.
• 🎧 Spotify pill (macOS, GitHub build) — add the Spotify pill in Settings → Active pills: album cover, title and artist, a progress bar you drag to seek, play/pause, previous/next, shuffle, repeat and volume, right from the notch; Mochi dances while it plays.
• 👗 Dress Mochi up — right-click him for the wardrobe. He also dresses up for the seasons on his own.
• ⌨️ Keyboard shortcuts — open the chat, jump to an alert or a terminal, switch pills, mute, send Mochi to the desktop or open the wardrobe from anywhere; all customizable in Settings → Shortcuts.
• 🎭 A real character — idle breathing, blinks, eyes on a sphere that follow your mouse, emotes, 28 handcrafted sounds, a greeting on launch.
• 🔊 Your own sounds (macOS) — drop a file named like one of Mochi's sounds (finish.wav, approval.mp3…) in Settings → General → Sound → Open sounds folder to replace it.
• 🗣️ « OK Coucou » (macOS, GitHub build) — talk to Mochi like Jarvis. Say « OK Coucou », then ask: « how much did I make on Stripe today? », « swap GitHub for Stripe », « play some Daft Punk », « who won the game last night? », « send an email to Enzo to tell him the image is ready ». Claude is the brain (your own Anthropic API key, set in Settings → Chat); speech recognition runs on your Mac, and only your words and the data Coucou reads to answer go to Anthropic, never audio. Mochi listens, thinks and answers out loud; emails open in the notch and leave only when you click Send. Settings → Voice.
• 🎙️ Dictate in the chat (macOS, GitHub build) — click the mic next to the chat field and talk in any of your languages (Coucou picks the one you spoke, or right-click the mic to choose); speech recognition runs on your Mac when it supports it.
• ↘️ The notch or a corner (macOS, GitHub build) — put Coucou in any corner of the screen: drag Mochi there, or Settings → General → Display → Position. A small tile with Mochi at rest; open, the other pills sit on a quarter circle around him.
• 🔎 Search the settings — type in the Coucou window's sidebar to find any setting (macOS GitHub build, Windows, Linux).
• 🫥 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. With several displays, pick his screen in Settings → General, or let him follow your mouse (macOS).
• 📱 Coucou on iPhone — your sessions, approvals and services in your pocket, with Live Activities, widgets and Siri. See Coucou on iPhone.
• 🤖 Coucou for Android — your agents, approvals with your fingerprint, questions, chat and home-screen widgets on an Android phone, linked to Coucou on Windows or Linux over your Wi-Fi. By @Rhytam23. See Coucou for Android.
• 📅 Weekly recap (macOS) — every Monday morning Coucou shows a summary of the past week: time coding, sessions, files, lines changed, commands, permissions, top agent and project, busiest day and longest session. Share it as a 1080 × 1920 image with Mochi — project names optional. All local, no sync.
• 🌍 16 languages — English, 简体中文, 繁體中文, हिन्दी, Español, العربية, Français, বাংলা, Português, Русский, Bahasa Indonesia, Deutsch, Türkçe, ไทย, 한국어, 日本語. Pick one in Settings → General → Language; Traditional Chinese and Thai are on the Mac only for now. Community translations welcome.
• 🔒 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 (and, once you agree, to GitHub's releases API to tell you about new versions).

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.

Get it on your iPhone in 3 steps: install Coucou on your iPhone (Join the TestFlight beta — free, App Store coming soon), turn on Settings → General → iPhone in the Mac app (0.1.9 or later), and use the same Apple Account in iCloud on both. Full guide, troubleshooting and build-it-yourself: docs/IPHONE.md.

Coucou for Android

Coucou for Android brings Mochi to Android phones. It was built by Rhytam Biswas (@Rhytam23) and lives in android/.

• 🔐 Approve from your phone — a permission request rises over any screen, even on a locked phone; Allow needs your fingerprint or screen lock, Deny doesn't. A command too long to show in full can only be allowed on the computer.
• 🧑‍💻 Your agents at a glance — the agent that needs you, the others below, plan usage and your services when the computer shares them.
• 💬 Answers and chat — answer Claude Code's questions and chat through the computer's own AI keys (the keys never leave the computer).
• 🏝️ An island over other apps (optional) — a black island drops from the camera cut-out while an agent works, plus a quick-settings tile and an ongoing notification.
• 🧩 Home-screen widgets — nine of them, from a tiny Mochi to a big card with plan usage and quick buttons. Orange when something waits for you, blue while it works, green when it's done. Read-only: a request is always decided in the app.
• 🔒 Local and private — the phone talks straight to your computer on your Wi-Fi, paired with a QR code and a pinned certificate. The phone link is off by default, and nothing listens until you turn it on.

Status: tested on a real phone (Android 13) with the Windows app. The phone link is in Coucou 0.4.0 for Windows and Linux. Download the signed APK from the latest Android release. Android needs Coucou on Windows or Linux (not the Mac), Android 11 or later, and both on the same Wi-Fi. Full guide: android/README.md.

Versions

macOS releases are published as v* tags. See CHANGELOG.md for the full notes of each version.

| Version | Date | Highlights | |---------|------|------------| | 0.5.8 | Oct 31, 2026 | Fixes by @Ohualtex: approvals and questions stay put, desktop Mochi stays visible, dropped files no longer overwrite each other | | 0.5.7 | Oct 31, 2026 | Mail in the notch: search, filters, reading, automatic sorting with rules and Undo, mail plans from the chat; search the settings; Coucou in a corner of the screen | | 0.5.6 | Oct 30, 2026 | Chat on your own AI subscription (Claude Code, Antigravity, Gemini CLI, Codex, Cursor, Copilot), switched on in Settings → Chat; Korean and Japanese | | 0.5.5 | Oct 29, 2026 | Chat on your Claude plan with no API key; each session apart behind its pill, questions side by side; Claude Code on a remote machine | | 0.5.4 | Oct 29, 2026 | Reliability: 25 community fixes — the hook server never gives up, your own hooks stay untouched, no crash without a mic, truer n8n, Stripe and GitHub pills | | 0.5.3 | Oct 22, 2026 | Mochi turns blue when a new version waits; What's new and your Coucou so far after each update; Buy Mochi a coffee | | 0.5.2 | Oct 20, 2026 | New version in the notch, one click to install it; German, Turkish, Thai, Traditional Chinese; Homebrew; plan approval from the notch | | 0.5.1 | Oct 18, 2026 | WhatsApp in one click: Coucou installs and starts the gateway, no Terminal | | 0.5.0 | Oct 18, 2026 | WhatsApp in the notch (experimental), Mochi feels your Mac, a screen capture for Claude, dictation that writes prompts or translates | | 0.4.0 | Oct 14, 2026 | Coucou becomes an app: Flow dictation anywhere, Parakeet offline, the Notetaker, a window in the Dock | | 0.3.0 | Oct 11, 2026 | « OK Coucou »: talk to Mochi, powered by Claude — pills, music, your services, web search, emails | | 0.2.3 | Oct 8, 2026 | Terminal sessions, Spotify, a colour per Mochi, dictation in any language, open on hover, your own sounds | | 0.2.2 | Oct 8, 2026 | Choose Mochi's screen, Claude Desktop pill, Codex plan usage, full questions, safer settings.json | | 0.2.1 | Oct 7, 2026 | Hermes Agent support | | 0.2.0 | Oct 6, 2026 | Copilot CLI, Muse Code, OpenCode and Amp, weekly recap, 10 languages | | 0.1.9 | Oct 6, 2026 | iPhone services with live details and actions, smarter Live Activity | | 0.1.8 | Oct 5, 2026 | Coucou on iPhone: sessions, widgets, approvals with Face ID, Mochi in the Dynamic Island | | 0.1.7 | Oct 4, 2026 | Keyboard shortcuts | | 0.1.6 | Oct 4, 2026 | Mochi on the desktop | | 0.1.5 | Oct 4, 2026 | Wardrobe and seasonal outfits, new launch greeting | | 0.1.4 | Oct 3, 2026 | Live diffs, GitHub pull requests, CI, reviews and contribution grid | | 0.1.3 | Oct 3, 2026 | Answer Claude's questions from the notch, plan usage, local models, Apple Music | | 0.1.2 | Oct 2, 2026 | Codex and Cursor support, the permission card stays until you answer | | 0.1.1 | Oct 2, 2026 | Gemini and OpenAI chat, Linux build, more agents and pills, security hardening | | 0.1.0 | Sep 27, 2026 | First release: Mochi, Claude Code sessions, chat, file drop, integrations |

Windows and Linux are released together, under the windows-v* and linux-v* tags. The newest Windows installer is always at windows-latest, the newest Linux AppImage at linux-latest.

| Windows & Linux | Date | Highlights | |---------|------|------------| | 0.5.8 · Windows · Linux | Oct 31, 2026 | 14 fixes and features by @Ohualtex: permission requests queue, Claude Desktop cards and pill, plan usage in the compact island, Flow pill in a corner | | 0.5.7 · Windows · Linux | Oct 31, 2026 | Mail with classic Outlook on Windows: search, filters, automatic sorting, mail plans from the chat; search the settings | | 0.5.6 · Windows · Linux | Oct 30, 2026 | Chat on your own AI subscription (Claude Code, Ant