Repolode
Submit
Louis-CFM

Louis-CFM/coucou

A macOS notch companion (plus Windows, Linux and phone apps) that shows live sessions from AI coding agents like Claude Code and Codex and lets you approve their requests.

Open-source alternative to:Wispr Flow

View on GitHubWebsite
Stars
5,561
Forks
970
Open issues
421
Last commit
yesterday

What is it?

Coucou is an open-source desktop companion that sits in the notch of a Mac, or along the top edge of the screen on Windows and Linux. It monitors AI coding agent sessions such as Claude Code, Codex, Cursor, Gemini CLI and Antigravity, showing what each agent reads, edits and runs. When an agent asks for permission or a choice, you can answer from the notch without switching windows.

The project also extends to an iPhone app with Live Activities, widgets and Siri shortcuts, and to an Android app that links to the Windows or Linux version over local Wi-Fi. On the Mac it includes a Flow dictation feature that pastes speech into any app, a meeting notetaker that records audio without a bot, and optional chat with several AI providers or local models through your own API keys.

The code is released under the MIT License. Keys are stored in the system keychain, and the app states it has no telemetry or account requirement.

Key features

  • 01Shows live steps, file edits and commands for Claude Code, Codex, Cursor and other agents.
  • 02Approve or deny permission requests and answer agent questions from the notch.
  • 03Jump to the terminal window of a running session on macOS.
  • 04Dictate text into any app by holding a key, with optional offline Parakeet recognition.
  • 05Companion apps for iPhone (Live Activities, widgets) and Android (approvals with fingerprint, home-screen widgets).

Use cases

  • Keeping an eye on several coding agent sessions while working on something else.
  • Approving agent file edits or shell commands from a phone when away from the desk.
  • Dictating prompts or messages into any Mac app with a held key.

Quick start

  1. 1

    Download the macOS app from the releases page

  2. 2

    Open the app and set up your AI coding agent hooks as described in the docs

Things to know

  • Most advanced features (dictation, Apple Music, Spotify, plan usage) are macOS-only.
  • Some features need your own API keys, such as Claude chat and clean-up.
  • Flow dictation and the Notetaker are not yet available on Windows or Linux.

Topics

#ai-agents#claude-code#macos#swift#menubar-app#dictation#code-review#anthropic#antigravity#claude

FAQ

What is coucou?
A macOS notch companion (plus Windows, Linux and phone apps) that shows live sessions from AI coding agents like Claude Code and Codex and lets you approve their requests. Coucou is an open-source desktop companion that sits in the notch of a Mac, or along the top edge of the screen on Windows and Linux. It monitors AI coding agent sessions such as Claude Code, Codex, Cursor, Gemini CLI and Antigravity, showing what each agent reads, edits and runs. When an agent asks for permission or a choice, you can answer from the notch without switching windows.
Is coucou free to use? What license does it have?
coucou is open source under the MIT license. Check the license terms before using it in commercial products.
Is coucou still maintained?
Actively maintained. The last commit to coucou was on Oct 18, 2026.
What can I use coucou for?
Keeping an eye on several coding agent sessions while working on something else. Approving agent file edits or shell commands from a phone when away from the desk. Dictating prompts or messages into any Mac app with a held key.
How do I install coucou?
Download the macOS app from the releases page Open the app and set up your AI coding agent hooks as described in the docs
Where can I get coucou?
The source code and installation instructions are on GitHub: https://github.com/Louis-CFM/coucou

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects