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.
Swift ai-agentsanthropicantigravityclaudeclaude-codecodexcursordynamic-islandgemini-cliiosiphonlinuxmacosmacos-appmenubar-appnotchopen-sourceswiftswiftuiwindows
Contributing to Coucou
Thanks for wanting to help Mochi grow up! 🫶
Getting started
brew install xcodegen
cd NotchBuddy && xcodegen && open NotchBuddy.xcodeproj
Never edit NotchBuddy.xcodeproj by hand: change project.yml and run xcodegen.
Check resting island dimensions on screens with and without a notch:
bash scripts/test-screen-geometry.sh
bash scripts/test-display-choice.sh
Check auto-close timing and live setting changes:
bash scripts/test-auto-close.sh
Check macOS translations:
python3 scripts/test-localization.py
Add English and Traditional Chinese entries for every new localized label. Keep format arguments and plural paths intact. This check does not replace building both Mac targets or checking the language and layout in the app.
Good first contributions
- A new service integration (a poller + an entry in
PillCatalog.swiftin the.servicecategory + a detail card). Look atStripePoller.swiftfor a compact example. - A new agent: any agent already gets its own automatic pill by sending
coucou_agentin its hook payload (seedocs/AGENTS.md). Add an entry inPillCatalog.swiftin the.agentor.workspacecategory only if you want it to be declarable in Settings → Active pills. - A new emote or sound for Mochi.
- Bug fixes — please describe how to reproduce.
Rules of the house
- Swift 6, SwiftUI + AppKit, no third-party dependencies unless there's really no other way.
- Secrets go in the Keychain, never on disk or in git.
- No telemetry, no network calls except to services the user configured.
- Never block Claude Code: if the app doesn't answer, the hook must exit right away.
- Never write
~/.claude/settings.jsonwithout a backup and the user's confirmation. - Keep it light: 0 % CPU when the island is hidden.
Pull requests
- One topic per PR, with a short GIF or screenshot for anything visual.
- Build must pass with no new warnings.