coucou README

The project's README from github.com/Louis-CFM/coucou. As one markdown file: README.md.

Coucou icon

Coucou

A tiny friend that lives in your MacBook's notch — or at the top of your screen on Windows — and keeps an eye on your Claude Code sessions.

Approve permissions, watch your agents work, drop a file, chat with Claude — all without leaving what you're doing.

macOS 15+ Windows 10/11 Swift 6 SwiftUI Tauri 2 License: MIT GitHub stars

Coucou in action

Why

Some studios showed off gorgeous notch companions… and never let anyone use them. Coucou is the open version. Every line of code, every animation, every sound — free to use, read, fork and remix.

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.

Features

Claude Code session Stripe payments
Chat with Claude Too many hits

Install

Download for macOS

  1. Grab the latest Coucou.zip from Releases.
  2. Unzip and move Coucou.app to /Applications.
  3. Launch. This build isn't notarized by Apple yet, so the first time macOS says it can't verify the developer: open System Settings → Privacy & Security, scroll down and click Open Anyway (only once).

Windows

The Windows installer is temporarily unavailable. Microsoft Defender wrongly flags the unsigned installer as malware; a false-positive report is under review at Microsoft and the installer will come back once it is cleared and signed. Until then you can build it from source.

There is no notch on a PC, so the island slides out of the top edge of the screen instead of hiding inside one. See windows/README.md for the rest of the differences.

Build from source

macOS — requirements: macOS 15+, Xcode 16+, XcodeGen.

brew install xcodegen
git clone https://github.com/Louis-CFM/coucou.git
cd coucou/NotchBuddy
xcodegen
open NotchBuddy.xcodeproj   # then ⌘R

Windows — requirements: Rust, Node 20+, MSVC build tools.

git clone https://github.com/Louis-CFM/coucou.git
cd coucou/windows
npm install
npm run pack                # installer lands in windows/release/

Setup

Click the Coucou icon in the menu bar (macOS) or in the system tray (Windows) → Settings…

What Why Where the key goes
Claude Code hooks live sessions and approvals Install hooks — Coucou backs up ~/.claude/settings.json, merges its hooks and shows you the diff before writing anything
Anthropic API key chat and questions about files Keychain / Windows Credential Manager
Stripe, n8n, GitHub, Vercel, Resend, Notion, Cal.com the integration pills Keychain / Windows Credential Manager, all optional

If Coucou isn't running, the hook exits immediately: Claude Code is never blocked.

Things to try

Do this Mochi does that
Hover the notch (top edge on Windows) peeks out and says hi 👋
Click it opens
Hover Mochi blinks, eyes grow
Click Mochi squish + annoyed
Click 3 times fast 😵‍💫 dizzy for a few seconds
Drag a file onto the island turns into a box and swallows it
Drag Mochi onto a window (macOS) attaches it as context

How it works

macOS

The macOS app is native Swift 6 / SwiftUI / AppKit with zero third-party dependencies.

Windows

Contributing

Issues and PRs are very welcome — new integrations, new emotes, new sounds, bug fixes. See CONTRIBUTING.md.

Credits

Built by Louis Raillé with Claude Code. Inspired by the notch-companion concepts shared by design studios — this project is independent and not affiliated with any of them.

License

If Mochi made you smile, a ⭐ helps a lot.

Website · Privacy · Terms · Support

coucou (Louis-CFM/coucou)

Searching Database…

5.4K ·GitHub
What is this?Coucou is a small animated character named Mochi that lives in your Mac's notch (or the top edge of the screen on Windows) and watches your AI coding agent sessions — Claude Code, Codex, Cursor, Gemini CLI and Antigravity — so you can approve permission requests and chat with Claude right from there.
Is this a menu bar app or something bigger?It is a native desktop app: a Swift/SwiftUI app on macOS with zero third-party dependencies, and a Tauri 2 (Rust + TypeScript) port on Windows, both controlled from a menu bar icon or system tray and showing the Mochi character floating near the notch or screen edge.
Is the Windows installer ready to use right now?No — Microsoft Defender currently flags the unsigned Windows installer as malware (a false positive under review), so it's pulled until it's signed; until then you have to build it from source. The macOS build also isn't notarized yet, so Gatekeeper warns on first launch and you need to click 'Open Anyway' in Privacy & Security.
Does Coucou send my data or keys anywhere?No — it has no telemetry and no account, and API keys and integration credentials are stored locally in the macOS Keychain or Windows Credential Manager; it only talks to the services you explicitly plug in.
Can I fork it and rebrand it as my own?The code is MIT, so you can use, fork and remix it, but the Coucou name, the Mochi character, icon, sounds and media are all rights reserved — the README asks forks to use their own name and character.
What is Mochi exactly?Mochi is Coucou's animated character: a soft squircle with eyes that follow your cursor, blinks and breathes while idle, gets annoyed or dizzy if you poke it too much, and jumps happily when a Claude Code session finishes.
What integrations does Coucou support besides Claude Code?It has optional integrations with Stripe payments, n8n workflows, GitHub, Vercel deployments, Resend emails, Notion and Cal.com, each shown as its own colored Mochi in the notch.
What happens if Coucou isn't running when a Claude Code hook fires?The hook script simply exits immediately, so Claude Code is never blocked waiting for the app.
How does Coucou see what Claude Code is doing?A small nb-hook script receives Claude Code's hook events and forwards them over a Unix socket (named pipe on Windows) to the app, which waits for your click on approval requests before answering the hook.
Creator
Louis-CFM
Size
21.9 MB
Stars
5.4K
Age
20d
Commits · 90 Days