Coucou Puts Claude Code Controls in the MacBook Notch

Coucou appeared on GitHub on September 27, 2026, as a small macOS utility with an unusually literal use for the MacBook notch. It places Claude Code session activity, permission requests, questions, and a compact chat interface inside the space surrounding the camera cutout. By the evening of September 30, the repository had reached roughly 1,200 GitHub stars and 150 forks, while the first packaged Mac release had recorded more than 1,300 downloads. Those numbers arrived within a little more than three days, which gives Coucou stronger evidence of actual installation than most new repositories that rise through GitHub Trending.

The visible character is called Mochi, a small animated figure that hides in the notch when nothing requires attention and reappears when Claude Code needs input. Its eyes follow the cursor, it reacts when clicked, and it plays one of several short sounds as sessions change state. Those details make Coucou look initially like a desktop pet, but the application is also functioning as an interrupt surface for coding agents. A permission request that would normally sit inside a terminal can instead appear at the top of the screen with controls for approving or denying the action.

Coucou moves Claude Code interruptions out of the terminal

Claude Code already exposes hooks that let other software react to events during a session, and Coucou builds most of its interaction around those hooks. The application can display what a running session is reading, editing, or executing, then notify the user when the session finishes or requires a decision. Permission prompts can be answered directly from the Coucou interface, while the Mac version can also open the terminal associated with a session. The result is less about replacing Claude Code than separating the parts that demand human attention from the terminal where the agent happens to be running.

That distinction becomes more useful when several coding sessions are active at once or when the user has moved into another application while an agent works. Claude Code can continue operating in the background until it reaches a permission boundary, at which point Coucou exposes the decision without requiring the user to search through terminal windows. The application also includes a built in Claude chat interface and accepts files dropped onto the notch for questions about their contents. On macOS, Mochi can be dragged onto another application window so that window can be attached as context for Claude.

The interface is playful, but the underlying problem is ordinary

Agent based coding tools create a new kind of desktop interruption that traditional notification systems do not handle particularly well. A coding agent may work independently for several minutes and then stop on a permission request, a clarification question, or another event that cannot proceed without the user. Ordinary desktop notifications can announce that something happened, but they are not normally designed to show the decision itself and return the answer to the waiting process. Coucou uses a permanently available part of the display to make those interruptions actionable rather than merely visible.

The approach also explains why the character design is more functional than it first appears. Mochi can remain almost invisible while no session requires attention, then change state as the agent begins working, asks for permission, or finishes. The application does not need to occupy a conventional window or demand a permanent section of the desktop, which is useful for a tool whose value depends on being available without becoming another workspace. On Windows, where there is no notch, the same interface retracts into the top edge of the display.

More than 1,300 people have already downloaded the first Mac release

Coucou 0.1.0 was published on September 27 with a single packaged Mac download. That Coucou.zip file had been downloaded more than 1,300 times by September 30, while the repository itself had passed roughly 1,200 stars and 150 forks. The ratio is notable because the release count is not merely tracking people who bookmarked the repository after seeing it on a trending page. A substantial portion of the early audience appears to have downloaded the actual application.

The repository is also receiving the kind of activity that usually follows installation rather than passive interest. Users have opened requests for Linux support, submitted changes to application behavior, and begun adding support for other coding agents. One open contribution adds Codex integration to the Windows version, including session activity, permission controls, and chat using an existing ChatGPT login or an API key. That work is not part of the current stable Mac release, but it suggests that Coucou may evolve from a Claude Code accessory into a broader control surface for local coding agents.

Installing Coucou changes Claude Code settings, but the change is visible

Coucou connects itself to Claude Code by adding hook entries to ~/.claude/settings.json. According to the project documentation, the application creates a backup first, shows the proposed changes before writing them, and preserves hooks that already exist in the file. The relay between Claude Code and Coucou uses a local Unix socket on macOS, while the Windows implementation uses a named pipe. If Coucou is not running, its hook is designed to exit rather than leave the Claude Code session waiting for the application.

The built in chat requires an Anthropic API key, which the developer says is stored in the macOS Keychain rather than in the application interface or an ordinary configuration file. Optional integrations are available for services including GitHub, Stripe, Vercel, Notion, n8n, Resend, and Cal.com, with their credentials handled through the same operating system credential storage approach. The developer states that Coucou contains no telemetry and communicates only with services the user configures, although that statement comes from the project documentation rather than an independent audit. The Claude Code monitoring and permission interface itself does not require the optional service integrations.

The Mac download is not notarized

The current Mac release is distributed directly through GitHub rather than through the Mac App Store. It is not notarized by Apple, so macOS may refuse to open it normally on first launch and display a warning that the developer cannot be verified. The project instructs users to approve the application through Privacy and Security settings or remove the quarantine attribute manually. That friction is common among small unsigned or unnotarized Mac projects, but it remains relevant for anyone expecting an ordinary signed installer.

Coucou currently requires macOS 15 or newer for the packaged Mac application. The macOS implementation is written in Swift and uses SwiftUI and AppKit, with the character animation drawn directly rather than through an external animation framework. The developer says the Mac application has no third party runtime dependencies. Users who prefer not to run the packaged build can compile it with Xcode 16 and XcodeGen.

Windows support exists, but the installer has been pulled for now

A separate Windows version has already been developed using Tauri, Rust, and TypeScript. Instead of occupying a notch, its interface sits against the top center of the screen and retracts when inactive, while Claude Code events are relayed through a small local executable. The Windows build supports permission decisions from terminals including Windows Terminal, PowerShell, VS Code, and Git Bash. It also stores configured credentials in Windows Credential Manager rather than in the application directory.

The downloadable Windows installer is temporarily unavailable. The developer says Microsoft Defender identified the unsigned installer as Trojan:Win32/Wacatac.H!ml, which the project describes as a machine learning false positive, and a report has been submitted to Microsoft while the developer works toward a signed installer. That explanation has not been independently established merely by the developer labeling the detection a false positive, so users should distinguish the project's account from a Microsoft determination. The Windows version can still be built locally from the repository, but there is currently no official Windows binary that ElseBoard can reasonably point readers toward as a normal download.

Coucou is becoming more interesting as coding agents become less visible

The terminal is an increasingly awkward place to supervise software that is designed to spend long stretches working without continuous input. Agent interfaces are beginning to separate execution from supervision, leaving users to intervene only when a decision, credential boundary, or clarification requires them. Coucou approaches that problem from the desktop rather than by building another full coding environment. Its small persistent interface acts as a place where background agent activity can surface briefly and then disappear again.

Whether that design survives beyond Claude Code will depend on how successfully Coucou absorbs other agent systems without turning the notch into another crowded notification center. The early Codex work suggests that the architecture can extend beyond a single provider, while the rapid growth in downloads and forks gives contributors an incentive to test that direction. The more consequential question is not whether Mochi remains a charming desktop character, but whether a small agent control layer becomes useful enough that developers keep it running every day. Three days of GitHub activity cannot answer that question, but Coucou has already moved beyond the stage where the idea exists only as a design concept.

Download Coucou for Mac

Coucou 0.1.0 is the current official packaged release for macOS 15 and newer. The download is a ZIP archive containing the Mac application, which can be moved into the Applications folder after extraction. The build is not notarized, so macOS may require manual approval before it opens for the first time. The official Mac download is available at https://github.com/Louis-CFM/coucou/releases/download/v0.1.0/Coucou.zip

Coucou on GitHub

The Coucou repository contains the Mac application, the developing Windows version, installation instructions, Claude Code hook implementation, open issues, and incoming contributions for additional agent support. Development has been moving quickly enough that features visible on the main branch may not yet exist in the packaged 0.1.0 Mac release. Windows users should check the repository before downloading anything from elsewhere because the project's own installer is currently unavailable. The official Coucou repository is https://github.com/Louis-CFM/coucou