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.5K ·GitHub
Что это?Coucou — это маленький анимированный персонаж по имени Mochi, который живёт в вырезе вашего Mac (или на верхнем крае экрана в Windows) и следит за сессиями ваших ИИ-агентов для кодинга — Claude Code, Codex, Cursor, Gemini CLI и Antigravity, — чтобы вы могли одобрять запросы разрешений и болтать с Claude прямо оттуда.
Это приложение в строке меню или нечто большее?Это нативное настольное приложение: на macOS — приложение на Swift/SwiftUI без единой сторонней зависимости, на Windows — порт на Tauri 2 (Rust + TypeScript); оба управляются через значок в строке меню или системный трей и показывают персонажа Mochi, парящего возле выреза или края экрана.
Установщик для Windows уже готов к использованию?Нет — Microsoft Defender сейчас помечает неподписанный установщик Windows как вредоносное ПО (ложное срабатывание, на рассмотрении), поэтому его убрали до подписи; до тех пор придётся собирать из исходников. Сборка macOS тоже пока не нотаризована, поэтому Gatekeeper предупреждает при первом запуске, и нужно нажать «Открыть в любом случае» (Open Anyway) в разделе «Конфиденциальность и безопасность».
Отправляет ли Coucou мои данные или ключи куда-либо?Нет — в нём нет телеметрии и аккаунта, а API-ключи и учётные данные интеграций хранятся локально в macOS Keychain или Windows Credential Manager; он общается только с теми сервисами, которые вы явно подключили.
Можно ли сделать форк и выдать его за своё?Код под MIT, так что использовать, форкать и перерабатывать можно, но имя Coucou, персонаж Mochi, значок, звуки и медиа защищены всеми правами — README просит форки использовать собственное имя и персонажа.
Что такое Mochi на самом деле?Mochi — анимированный персонаж Coucou: мягкий сквиркл с глазами, следящими за вашим курсором; в простое он мигает и «дышит», дуется или кружится, если тыкать его слишком часто, и радостно подпрыгивает, когда завершается сессия Claude Code.
Какие интеграции поддерживает Coucou кроме Claude Code?Есть опциональные интеграции с платежами Stripe, воркфлоу n8n, GitHub, деплоями Vercel, письмами Resend, Notion и Cal.com — каждая показана своим цветным Mochi в вырезе.
Что произойдёт, если Coucou не запущен в момент срабатывания хука Claude Code?Скрипт хука просто немедленно завершается, так что Claude Code никогда не блокируется в ожидании приложения.
Как Coucou узнаёт, что делает Claude Code?Небольшой скрипт nb-hook получает события хуков Claude Code и пересылает их через Unix-сокет (named pipe в Windows) приложению, которое ждёт вашего клика по запросам на разрешение, прежде чем ответить хуку.
Creator
Louis-CFM
Size
22.2 MB
Stars
5.5K
Age
21d
Commits · 90 Days