What is Coucou?
Coucou puts a small animated character, Mochi, in the MacBook notch (or at the top of the screen on Windows and Linux) and feeds it live events from coding agents through their hooks. You see what Claude Code, Codex, Cursor, Gemini CLI, Antigravity, Copilot CLI, OpenCode, Amp and others are reading, editing and running, and you can answer Claude Code's permission requests with Allow, Deny or Always, or its multiple-choice questions, without switching to the terminal.
Around that core it has grown a lot: offline dictation with NVIDIA's Parakeet, a call notetaker, chat with several model providers, pills for GitHub, Stripe or Vercel, mail, WhatsApp and a crypto portfolio. An iPhone app (TestFlight beta) mirrors sessions to the Lock Screen and Dynamic Island through your own iCloud, and an Android app pairs with the desktop over Wi-Fi. The code is MIT licensed, but the name, character, icon and sounds are reserved by the author. The repository was created on 27 September 2026 and has about 7,380 stars.
Is Coucou worth it?
The real problem Coucou solves is small and constant: a coding agent stops to ask permission, and you do not notice because the terminal is behind three other windows. Coucou installs hooks for Claude Code (it backs up ~/.claude/settings.json and shows you the diff first) and for Gemini CLI, receives their events over a local Unix socket or named pipe, and shows each session as a pill in the notch. Permission cards stay until you answer, and AskUserQuestion prompts with up to 4 questions can be answered in place.
The security design is more thoughtful than the cartoon suggests. There is no account and no telemetry; keys sit in the macOS Keychain, Windows Credential Manager or Linux Secret Service. The iPhone link syncs through your private CloudKit database with project names, commands and questions encrypted by your iCloud keys, and the stateless Cloudflare Worker that pushes Live Activities sees only the agent's name and state. The Android phone link is a local-network server that is off by default, pairs by QR code and pins its TLS certificate. The WhatsApp bridge listens on 127.0.0.1, port 47823 by default, with HMAC-SHA256 signed deliveries.
The weakness is scope. Since the first release on 27 September 2026 the app has added dictation, a call recorder, mail sorting, WhatsApp, Spotify, a crypto portfolio across 16 networks and 5 exchanges, and a voice assistant. Each is optional, but together they turn a notification tool into something that may hold your exchange keys, mail and agent approvals at once. The repository has 452 open issues, the Windows installer is not code-signed yet, and the iPhone app is a TestFlight beta capped by Apple at 10,000 testers.
Against herdr or Claude Squad, which manage agent sessions in the terminal, Coucou does not run or organise agents at all; it watches them and lets you answer. That is the right split for someone who already likes their terminal setup and only wants to stop missing prompts. Turn on the agent hooks, leave the rest off, and it earns its place in the notch.
Where it earns its place
A freelance developer running two Claude Code sessions on a MacBook
Stop leaving an agent idle while it waits for approval
Install via Homebrew, click Install hooks, and approve requests from the notch card with Allow, Deny or Always. Free; the only cost is your existing Claude plan.
An engineer who steps away from the desk during long agent runs
Approve or deny a command from the phone
On a Mac, enable the iPhone link and join the TestFlight beta; the session moves to the Lock Screen when the Mac locks. On Windows or Linux, turn on the Android phone link and scan the pairing code on the same Wi-Fi.
A team lead watching Codex and Gemini CLI side by side
See at a glance which agent is working, which is done and which is stuck
Each session gets its own pill with live steps and diffs, and Codex also gets Allow and Deny. Custom agents can join by tagging hook payloads with coucou_agent.
Before you commit
- Setup
- Mac: brew install --cask coucou (macOS 15 or later), launch, Install hooks. Windows and Linux: download the installer or AppImage; Windows shows a SmartScreen warning because it is unsigned. Minutes to first approval.
- Integrations
- Hooks for Claude Code and Gemini CLI, plus support for Codex, Cursor, Antigravity, Copilot CLI, OpenCode, Amp, Hermes and Claude Desktop; chat via Anthropic, Google, OpenAI, DeepSeek, Qwen, Moonshot, Ollama or LM Studio; pills for GitHub, Vercel, Stripe, Cal.com, n8n, Notion and Resend.
- Data and privacy
- No account and no telemetry; the app contacts GitHub's releases API only after you agree. Keys are kept in the OS keychain. iPhone sync uses your private CloudKit database with sensitive fields encrypted; the push relay sees only agent name and state. The Android link is off by default and LAN-only. Call audio is deleted once the transcript is written.
- Cost at scale
- No licence cost. Model use for chat, dictation clean-up and call notes is billed by your provider or comes out of your existing subscription; Parakeet dictation runs offline after a download of about 650 MB.
- Limits
- Mac App Store build drops most agents beyond Claude Code, Cursor and Claude Desktop because of the sandbox; iPhone beta limited to 10,000 testers; Parakeet needs Apple silicon; 452 open issues.
What’s good
- Answers Claude Code permission prompts and questions from the notch or Lock Screen
- No account or telemetry; keys in the OS keychain
- Phone links are opt-in: encrypted iCloud sync, or pinned TLS on local Wi-Fi
- Works with more than ten coding agents, plus a generic hook tag
What’s not
- Feature sprawl: mail, WhatsApp, crypto and voice assistant alongside agent approvals
- 452 open issues and releases every few days
- Windows installer not code-signed; iPhone app still a TestFlight beta
- Name, character and sounds are not MIT, so forks must rebrand
Best for
Developers who run Claude Code or Codex in a terminal and keep missing the moment an agent stops to ask permission.
Coucou alternatives
Coucou: common questions
- Is Coucou worth it?
- Coucou is the most pleasant way to see when an agent is waiting on you, but it now does a dozen other jobs, and every one of them is another key or permission handed to a two-month-old app. We rate it 3.8 out of 5.
- How much does Coucou cost?
- Free and open source (MIT for code; name, character and sounds reserved). Chat and notetaking use your own API keys or an existing Claude, ChatGPT or other subscription through its official CLI.
- What are the downsides of Coucou?
- Feature sprawl: mail, WhatsApp, crypto and voice assistant alongside agent approvals; 452 open issues and releases every few days; windows installer not code-signed; iPhone app still a TestFlight beta; name, character and sounds are not MIT, so forks must rebrand.
- Who is Coucou best for?
- Developers who run Claude Code or Codex in a terminal and keep missing the moment an agent stops to ask permission.
- How much does Coucou cost for a team or in production?
- No licence cost. Model use for chat, dictation clean-up and call notes is billed by your provider or comes out of your existing subscription; Parakeet dictation runs offline after a download of about 650 MB.
- Is Coucou safe for company data?
- No account and no telemetry; the app contacts GitHub's releases API only after you agree. Keys are kept in the OS keychain. iPhone sync uses your private CloudKit database with sensitive fields encrypted; the push relay sees only agent name and state. The Android link is off by default and LAN-only. Call audio is deleted once the transcript is written.
- What are the best Coucou alternatives?
- The closest alternatives we have reviewed are herdr, Claude Squad and Vibe Kanban.
Answers checked Nov 21, 2026.