Coucou: The notch app that turns AI agents into a character
A deep look at the socket bridge, state machine, and animated “Mochi” layer that make terminal workflows feel visible, responsive, and oddly alive.

A tiny friend that lives in your notch (macOS) or at the top of your screen (Windows, Linux) and keeps an eye on your coding agents: Claude Code, Codex, Cursor, Gemini CLI, Antigravity and more.
- Coucou’s real invention is not a notch widget, but a character layer that makes agent activity legible, emotional, and easy to trust.
- Its socket bridge and approval loop turn a local CLI workflow into a reversible control surface without dragging the user back to the terminal.
- The app’s state machine matters because it separates what the island is from how the character animates, which keeps behavior crisp and predictable.
- Coucou stands out by combining personality, local-first control, and cross-platform reach in a category that usually offers only one of those three.
Why Mochi matters
Coucou’s most unusual idea is also its most obvious one once you see it: Mochi makes agent activity feel embodied. Instead of treating the notch as a tiny meter, the app turns it into a character that reacts, hesitates, blinks, and asks for permission like a little coworker perched at the top of the screen.
That matters because AI agent workflows are full of ambiguity. You are not just watching progress. You are deciding whether to trust a process that is changing files, asking for approvals, and moving through tasks you may not be reading line by line.
The bridge between terminal and notch
Under the character layer, Coucou is doing something very plain and very important. It listens to local agent events through a Unix domain socket, translates them into application state, and sends approval responses back the same way. That is why it feels responsive instead of ornamental.
A character engine, not a widget stack
The codebase makes a clear bet: animation should come from an engine, not from scattered view transitions. That is why the project leans on pieces like BotEngine and BotCanvasView rather than treating Mochi as a static status element.
The practical effect is that the character can express internal state. It can look around, morph, dance, blink, or react to file drops and approval prompts. Those behaviors are not decorative extras. They are the interface.
This is also where the product becomes easier to trust. When motion is driven by state, the UI stops feeling like a pile of effects and starts feeling like a system with memory.
What the state machine is actually doing
Coucou separates the island’s visible mode from the broader app state. The island can be hidden, petit, home, or coucou, and that distinction matters because the app is always deciding how much surface area to expose, when to collapse, and when to keep attention on the workflow.
That separation is the difference between a clever animation and a product that can hold timing under pressure. The state machine owns transitions. The character engine owns motion. App state owns truth.
| State | What it means | Why it matters |
|---|---|---|
| Hidden | Nothing is surfaced in the notch. | Keeps the interface out of the way when no attention is needed. |
| Petit | A compact presence is visible. | Signals that the system is awake without demanding focus. |
| Home | The island is expanded into a usable surface. | Makes room for tasks, notifications, and approvals. |
| Coucou | The full character experience is active. | Lets Mochi become expressive when the workflow needs it. |
Why this feels different from other notch tools
The category is crowded with tools that live in the notch, but most of them are utilities first. Coucou’s edge is that it combines a local-first control surface with a character model and broader platform reach. It wants to be useful, but it also wants to be legible.
That gives it a distinct middle ground. It is more expressive than a simple session monitor, more interactive than a passive notification strip, and less locked into one platform than macOS-only companions.
The comparison is less about winners than about product shape. Some tools optimize for power-user density. Others optimize for polish. Coucou tries to make the agent workflow feel like a relationship you can actually watch.
| Project | Platform | Interaction model | Personality | Approval handling | Best fit |
|---|---|---|---|---|---|
| Coucou | macOS, Windows, Linux | Character-first notch companion | High | Inline Allow / Deny | People who want agent oversight to feel alive and immediate |
| Notchcode | macOS | Notch-first monitor | Low | Basic | Users who want simple monitoring with minimal flair |
| Vibe Island | macOS | Control panel | Low to medium | Strong | Developers who want a utility-focused command surface |
| Claude Peek | macOS only | Session viewer | Low | Limited | Users focused on observing multiple sessions and history |
| ccmux | Terminal | TUI workflow | None | Terminal-native | Power users who prefer tmux-style control over a GUI |
The broader bet: ambient control for AI workflows
Coucou is bigger than its notch. The product points toward a future where agent work is supervised through ambient surfaces that stay present without taking over the desktop. Approvals, progress, and context can live in a persistent layer that is fast to glance at and fast to act on.
That is why the project matters even if you never use Mochi exactly as shipped. It is a prototype for a new kind of developer interface: one that treats oversight, trust, and personality as part of the workflow instead of as separate concerns.





