TL;DR: Coucou acts as a persistent overlay in the macOS notch, hooking into various AI coding agents like Claude Code, Cursor, and Gemini CLI.
Best for: Developers using AI coding agents who are tired of constant terminal context switching.
Repository snapshot: ⭐ 7 136 stars · 🍴 1 174 forks · Swift · MIT
Daily picks: Follow GitHub Open Source on Telegram
What it is
Coucou is an open-source utility written in Swift that acts as a persistent overlay in the macOS notch. It integrates with popular coding assistants like Claude Code, Cursor, and Gemini CLI to surface real-time status updates and permission requests directly in your menu bar area.
How it works
The application monitors background events and file modifications from your active coding tools. Instead of forcing you to check terminal windows manually, it intercepts requests and renders them as interactive pills. You can inspect file diff metrics and handle permissions immediately.
Key features
- Approve or deny background agent requests directly from the macOS notch
- Track live file diff counts for incoming modifications
- Support for multiple coding assistants including Claude Code and Cursor
- Control supplementary system tasks like music and dictation
- Customizable character overlay for status visualization
Getting started
Clone the repository from GitHub and build the project locally using Xcode on macOS:
git clone https://github.com/Louis-CFM/coucou.git
cd coucou
Open the project workspace and build it for your local machine.
When not to use it
If you do not use terminal-based coding assistants or if you are not running macOS, this tool will not provide any utility for your workflow.
Discuss
Do you prefer your AI agent feedback in the terminal or as a system-level overlay?
Curated from the repository README and metadata. No hands-on test is claimed; evaluate it in a sandbox before production use.
Top comments (0)