Skip to content

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.

Mac 0.4.0: CHANGELOG, README with the Coucou window, version 0.4.0 (16), aligned pickers in the window

Claude9cbd2f8e7f14
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 798b480f..5cd9bb49 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,11 +1,15 @@
# Changelog
-## Unreleased
+## 0.4.0 — October 14, 2026
-- **Flow dictation** *(macOS, GitHub build)* — hold a key anywhere on the Mac (right ⌥ by default, or right ⌘, right ⌃ or fn), speak, let go: your words are pasted where you type, like Wispr Flow. A small pill rests at the bottom of the screen while Flow dictation is on; when you speak it opens into Mochi and nine dots rising and falling with the graves and the aigus of your voice. Two quick taps keep it listening hands-free until the next tap; Esc cancels. Speech is recognised by the Mac (on-device when it can), and the clipboard gets back what it held after the paste. Off by default — Settings → Voice; it needs the Accessibility permission to see the key and paste
-- **Coucou Flow** *(macOS, GitHub build)* — a window for the dictation, from the menu bar (Coucou Flow…) or Settings → Voice. **Dictation**: today's dictations with search and copy, total words, words per minute and days in a row. **Statistics**: words, time saved, speed, words per day and the apps you dictate in. **Dictionary**: names Coucou always spells right, and replacements (« cloud code » → « Claude Code »). **Snippets**: say a short phrase, the whole text is pasted. **Styles**: an optional clean-up by Claude with your own key (no « euh », no repeats, corrections kept), as said, natural or polished, per app. ⌃⌘V pastes the last dictation again, ⌘V follows your keyboard layout and clipboard managers leave the dictation out
-- **Parakeet** *(macOS, GitHub build)* — dictation can run on NVIDIA's Parakeet through [FluidAudio](https://github.com/FluidInference/FluidAudio), on the Mac's Neural Engine: more accurate, offline, 25 languages. Nothing is downloaded until you click Download in Coucou Flow → Settings (about 650 MB, once); until then the Mac's own recognition is used. Apple silicon only
-- **Notetaker** *(macOS, GitHub build)* — click Record a call: Coucou records your microphone and what the Mac plays (no bot joins the call), shows the words live, then writes the transcript person by person — you, Person 2, Person 3… which you can rename — with a summary, key points and the to-dos, by Claude with your key or by Apple Intelligence. Copy it as Markdown or export it. A red pill at the bottom of the screen shows the time and stops the recording. Notes stay on your Mac and the audio is deleted once the transcript is written; tell the people in the call that you record
+Coucou becomes a real app: a window in the Dock, dictation everywhere on the Mac, and notes of your calls. All of it free and open source.
+
+- **Coucou, the app** *(macOS, GitHub build)* — Coucou now has its own window and sits in the Dock. Open it and everything is in one place: on the left, **Flow** (Dictation, Notetaker, Statistics, Dictionary, Snippets, Styles, Settings), then **Notch** (General, Active pills, Agents, Chat, Integrations, Voice, Shortcuts), the same settings as before. The window opens when you launch Coucou yourself, not when it starts with your Mac; ⌘, opens the settings, and the Dock icon can be turned off in Settings → App. Each page has its own colour and a band of little Mochis that walk around, wave, hop and react when you poke them, over a deep black with particles that drift away from the pointer
+- **Flow dictation** *(macOS, GitHub build)* — hold a key anywhere on the Mac (right ⌥ by default, or fn, right ⌘ or right ⌃), speak, let go: your words are pasted where you type, like Wispr Flow. Two quick taps keep it listening hands-free until the next tap; Esc cancels; ⌃⌘V pastes the last dictation again. ⌘V follows your keyboard layout, clipboard managers leave the dictation out, and the clipboard gets back what it held. When no text field has the focus, the words are kept on the clipboard and a message says so. Off by default; it needs the Accessibility permission to see the key and paste
+- **The pill** — a small see-through pill rests at the bottom of the screen while Flow dictation is on. Hover it and it opens into a toolbar: Mochi, dictate hands-free, record a call, open the Coucou window, each with its tip. When you speak, Mochi and nine dots rise and fall with the low and high notes of your voice. Put it at the bottom, on the left or on the right of the screen: on the sides it stands up and everything in it is stacked. Messages (a dictation kept on the clipboard, a microphone that is off) show in a bubble next to it, with a button to act
+- **Your words, your way** — **Dictionary**: names Coucou always spells right, and replacements (« cloud code » → « Claude Code »). **Snippets**: say a short phrase, the whole text is pasted, untouched. **Styles**: an optional clean-up by Claude with your own key (no « um », no repeats, your corrections applied), as said, natural or polished, per app. **Statistics**: words, time saved, speed, words per day and the apps you dictate in. Your history stays on your Mac, kept as long as you choose
+- **Parakeet** *(macOS, GitHub build)* — dictation can run on NVIDIA's Parakeet through [FluidAudio](https://github.com/FluidInference/FluidAudio), on the Mac's Neural Engine: more accurate, offline, 25 languages. Nothing is downloaded until you click Download in Coucou → Settings (about 650 MB, once); until then the Mac's own recognition is used. Apple silicon only
+- **Notetaker** *(macOS, GitHub build)* — click Record a call: Coucou records your microphone and what the Mac plays (no bot joins the call), shows the words live, then writes the transcript person by person — you, Person 2, Person 3… which you can rename — with a summary, key points and the to-dos, by Claude with your key or by Apple Intelligence on your Mac. Copy it as Markdown or export it. The pill turns red with the time and a button to stop. Notes stay on your Mac and the audio is deleted once the transcript is written; tell the people in the call that you record
## Android 0.2.0 — October 13, 2026
diff --git a/NotchBuddy/Resources/Info.plist b/NotchBuddy/Resources/Info.plist
index 137f0781..20ec715b 100644
--- a/NotchBuddy/Resources/Info.plist
+++ b/NotchBuddy/Resources/Info.plist
@@ -30,9 +30,9 @@
<key>CFBundlePackageType</key>
<string>APPL</string>
<key>CFBundleShortVersionString</key>
- <string>0.3.0</string>
+ <string>0.4.0</string>
<key>CFBundleVersion</key>
- <string>15</string>
+ <string>16</string>
<key>LSUIElement</key>
<true/>
<key>NSAccessibilityUsageDescription</key>
diff --git a/NotchBuddy/Sources/App/FlowHubInsights.swift b/NotchBuddy/Sources/App/FlowHubInsights.swift
index 9e3494f2..38786055 100644
--- a/NotchBuddy/Sources/App/FlowHubInsights.swift
+++ b/NotchBuddy/Sources/App/FlowHubInsights.swift
@@ -37,7 +37,7 @@ struct HubInsightsPage: View {
}
.pickerStyle(.segmented)
.labelsHidden()
- .frame(width: 250)
+ .fixedSize()
} content: {
HStack(spacing: 14) {
HubStatCard(label: String(localized: "hub.stat.words"),
diff --git a/NotchBuddy/Sources/App/FlowHubNotes.swift b/NotchBuddy/Sources/App/FlowHubNotes.swift
index 7e235c5f..7bd71a57 100644
--- a/NotchBuddy/Sources/App/FlowHubNotes.swift
+++ b/NotchBuddy/Sources/App/FlowHubNotes.swift
@@ -18,8 +18,8 @@ struct HubNotesPage: View {
VStack(spacing: 0) {
HubHero(page: .notes, title: String(localized: "hub.page.notes"),
subtitle: String(localized: "hub.notes-promo"), compact: true)
- .padding(.horizontal, 20)
- .padding(.top, 20)
+ .padding(.horizontal, 28)
+ .padding(.top, 24)
HStack(spacing: 0) {
HubNotesList(selected: $selected)
.frame(width: 280)
@@ -379,7 +379,7 @@ private struct HubNoteDetail: View {
}
.pickerStyle(.segmented)
.labelsHidden()
- .frame(width: 280)
+ .fixedSize()
if tab == 0 { summary } else { transcript }
}
}
@@ -645,7 +645,7 @@ struct HubSummaryEnginePicker: View {
}
}
.labelsHidden()
- .frame(width: 190)
+ .fixedSize()
}
}
}
diff --git a/NotchBuddy/Sources/App/FlowHubSettings.swift b/NotchBuddy/Sources/App/FlowHubSettings.swift
index 59d5ba3d..c8854669 100644
--- a/NotchBuddy/Sources/App/FlowHubSettings.swift
+++ b/NotchBuddy/Sources/App/FlowHubSettings.swift
@@ -25,7 +25,7 @@ struct HubSettingsPage: View {
ForEach(FlowKey.allCases) { Text(verbatim: $0.label).tag($0) }
}
.labelsHidden()
- .frame(width: 170)
+ .fixedSize()
}
HubDivider()
HubRow(title: String(localized: "flow.edge")) {
@@ -34,7 +34,7 @@ struct HubSettingsPage: View {
}
.pickerStyle(.segmented)
.labelsHidden()
- .frame(width: 240)
+ .fixedSize()
}
HubDivider()
HubRow(title: String(localized: "hub.settings.handsfree"),
@@ -113,7 +113,7 @@ struct HubSettingsPage: View {
Text("hub.keep.forever").tag(-1)
}
.labelsHidden()
- .frame(width: 170)
+ .fixedSize()
}
HubDivider()
HStack(spacing: 8) {
@@ -181,7 +181,7 @@ struct HubRecognitionSettings: View {
}
}
.labelsHidden()
- .frame(width: 220)
+ .fixedSize()
}
} else if !parakeet.isReady {
Text("hub.engine.fallback")
diff --git a/NotchBuddy/Sources/App/FlowHubWords.swift b/NotchBuddy/Sources/App/FlowHubWords.swift
index 7626673e..823a8e7e 100644
--- a/NotchBuddy/Sources/App/FlowHubWords.swift
+++ b/NotchBuddy/Sources/App/FlowHubWords.swift
@@ -303,7 +303,7 @@ struct HubStylesPage: View {
ForEach(FlowStyle.allCases) { Text($0.label).tag($0) }
}
.labelsHidden()
- .frame(width: 150)
+ .fixedSize()
}
/// Running apps with windows that have no style of their own yet.
diff --git a/NotchBuddy/Sources/App/SettingsView.swift b/NotchBuddy/Sources/App/SettingsView.swift
index 6dad9804..b7f379d6 100644
--- a/NotchBuddy/Sources/App/SettingsView.swift
+++ b/NotchBuddy/Sources/App/SettingsView.swift
@@ -221,7 +221,7 @@ struct SettingsView: View {
.padding(.horizontal, embeddedSection == nil ? 20 : 28)
.padding(.top, embeddedSection == nil ? 0 : 20)
.padding(.bottom, 16)
- .frame(maxWidth: embeddedSection == nil ? .infinity : 760, alignment: .leading)
+ .frame(maxWidth: embeddedSection == nil ? .infinity : 1100, alignment: .leading)
}
if !statusMessage.isEmpty {
Divider()
diff --git a/NotchBuddy/project.yml b/NotchBuddy/project.yml
index 26d68f75..84952d5e 100644
--- a/NotchBuddy/project.yml
+++ b/NotchBuddy/project.yml
@@ -137,8 +137,8 @@ targets:
CFBundleName: Coucou
CFBundleDisplayName: Coucou
CFBundleIdentifier: fr.louisraille.NotchBuddy
- CFBundleVersion: "15"
- CFBundleShortVersionString: "0.3.0"
+ CFBundleVersion: "16"
+ CFBundleShortVersionString: "0.4.0"
CFBundlePackageType: APPL
LSUIElement: YES
NSHighResolutionCapable: YES
diff --git a/README.md b/README.md
index 71c25fb0..595d3268 100644
--- a/README.md
+++ b/README.md
@@ -8,6 +8,8 @@
Approve permissions, watch your agents work, drop a file, chat with Claude — all without leaving what you're doing. Walk away from your Mac and Mochi follows you to your iPhone: Lock Screen, Dynamic Island, widgets, Siri.
+**New in 0.4: Coucou is a real Mac app.** Hold a key anywhere, speak, let go: your words are pasted where you type, like Wispr Flow — free, open source, and offline with Parakeet. Record your calls without a bot in the meeting and get the transcript, the summary and the to-dos.
+
[![Version](https://img.shields.io/github/v/release/Louis-CFM/coucou?filter=v*&label=version&color=0A84FF)](https://github.com/Louis-CFM/coucou/releases)
![macOS 15+](https://img.shields.io/badge/macOS-15%2B-black?logo=apple)
![iOS 18+](https://img.shields.io/badge/iOS-18%2B-black?logo=apple)
@@ -33,6 +35,31 @@ Some studios showed off gorgeous notch companions… and never let anyone use th
Meet **Mochi**: a soft little squircle with big eyes that pops out of your notch, waves hello, follows your cursor with its eyes, gets annoyed when you poke it (and dizzy if you insist), and tells you the moment Claude Code needs you.
+## Coucou on the Mac: dictation, notes, one window
+
+<div align="center">
+<img src="docs/media/hub-dictation.png" width="760" alt="The Coucou window: the Dictation page with today's dictations, words dictated, speed and days in a row">
+</div>
+
+Since 0.4, Coucou has its own window and sits in the Dock. On the left, **Flow** — everything about your voice — and **Notch**, all the settings of the island. *(macOS, GitHub build)*
+
+- 🎙️ **Flow dictation** — hold a key anywhere on the Mac (right ⌥ by default, or fn, right ⌘ or right ⌃), speak, let go: your words are pasted where you type, in any app. Two quick taps for hands-free, Esc to cancel, ⌃⌘V to paste the last one again. Your clipboard gets back what it held.
+- 💊 **The pill** — a small see-through pill at the bottom of the screen (or on its left or right edge). Hover it for a toolbar: dictate, record a call, open Coucou. While you speak, Mochi listens and nine dots follow your voice.
+- 🦜 **Parakeet, offline** — run NVIDIA's Parakeet on your Mac's Neural Engine through [FluidAudio](https://github.com/FluidInference/FluidAudio): more accurate, 25 languages, nothing leaves your Mac. One click to download (about 650 MB), Apple silicon only. Until then the Mac's own recognition is used.
+- ✍️ **Your words, your way** — a dictionary of names Coucou always spells right, replacements, snippets (say a short phrase, paste a whole text), and an optional clean-up by Claude with your own key: as said, natural or polished, per app.
+- 📝 **Notetaker** — click Record a call: Coucou records your microphone and what your Mac plays, no bot joins the call. Then you get the transcript person by person, a summary, the key points and the to-dos, written by Claude with your key or by Apple Intelligence on your Mac. The audio is deleted once the transcript is written. Tell the people in the call that you record.
+- 📊 **Statistics** — words dictated, time saved, words per minute, days in a row and the apps you dictate in. Counted on your Mac, never sent anywhere.
+
+<table>
+<tr>
+<td width="33%"><img src="docs/media/hub-statistics.png" alt="Statistics: words dictated, time saved, speed, words per day and where you dictate"></td>
+<td width="33%"><img src="docs/media/hub-styles.png" alt="Styles: an optional clean-up by Claude, as said, natural or polished, per app"></td>
+<td width="33%"><img src="docs/media/hub-settings.png" alt="Settings: the key to hold, where the pill is, hands-free, paste again and cancel"></td>
+</tr>
+</table>
+
+Flow dictation and the Notetaker are on the Mac for now; Windows and Linux are next.
+
## Features
- 🤖 **Claude Code, Cursor, Codex, Gemini CLI, Antigravity, Copilot CLI, Muse Code, OpenCode, Amp, Hermes, Claude Desktop and other agents, live** — see every session in your notch: what it reads, edits and runs, step by step. Tag a hook payload with `coucou_agent` to give any agent its own pill (see [`docs/AGENTS.md`](docs/AGENTS.md)). Finished? Mochi does a happy little jump.
@@ -121,6 +148,7 @@ macOS releases are published as `v*` tags. See [CHANGELOG.md](CHANGELOG.md) for
| Version | Date | Highlights |
|---------|------|------------|
+| [0.4.0](https://github.com/Louis-CFM/coucou/releases/tag/v0.4.0) | Oct 14, 2026 | Coucou becomes an app: Flow dictation anywhere, Parakeet offline, the Notetaker, a window in the Dock |
| [0.3.0](https://github.com/Louis-CFM/coucou/releases/tag/v0.3.0) | Oct 11, 2026 | « OK Coucou »: talk to Mochi, powered by Claude — pills, music, your services, web search, emails |
| [0.2.3](https://github.com/Louis-CFM/coucou/releases/tag/v0.2.3) | Oct 8, 2026 | Terminal sessions, Spotify, a colour per Mochi, dictation in any language, open on hover, your own sounds |
| [0.2.2](https://github.com/Louis-CFM/coucou/releases/tag/v0.2.2) | Oct 8, 2026 | Choose Mochi's screen, Claude Desktop pill, Codex plan usage, full questions, safer settings.json |
@@ -268,14 +296,14 @@ cd coucou/android
## Setup
-Click the Coucou icon in the menu bar (macOS) or in the system tray (Windows, Linux) → **Settings…**
+On the Mac, open Coucou from the Dock or the menu bar: its window has every setting under **Notch** (⌘,). On Windows and Linux, click the Coucou icon in the system tray → **Settings…**
| What | Why | Where the key goes |
|---|---|---|
| **Claude Code hooks** | live sessions and approvals | **Install hooks** — Coucou backs up `~/.claude/settings.json`, merges its hooks and shows you the diff before writing anything |
| **Claude plan** *(macOS, GitHub build)* | Plan usage gauge in the notch header | **Install relay** in Settings → Agents → Plan usage, then enable "Show in the notch" |
-| **Gemini CLI hooks** *(macOS)* | Gemini CLI sessions in the island | **Install hooks** in Settings → Gemini CLI — backs up `~/.gemini/settings.json` |
-| **Antigravity (agy) hooks** *(macOS)* | agy sessions in the island | **Install hooks** in Settings → Antigravity — backs up `~/.gemini/config/hooks.json` |
+| **Gemini CLI hooks** | Gemini CLI sessions in the island | **Install hooks** in Settings → Gemini CLI — backs up `~/.gemini/settings.json` |
+| **Antigravity (agy) hooks** | agy sessions in the island | **Install hooks** in Settings → Antigravity — backs up `~/.gemini/config/hooks.json` |
| **Anthropic API key** | chat and questions about files | Settings → Anthropic API · Keychain / Windows Credential Manager / Secret Service |
| **Google AI API key** *(macOS)* | chat with Google AI (Gemini) | Settings → Chat — other providers · Keychain |
| **OpenAI API key** *(macOS)* | chat with OpenAI | Settings → Chat — other providers · Keychain |
@@ -284,24 +312,26 @@ Click the Coucou icon in the menu bar (macOS) or in the system tray (Windows, Li
| **iPhone** *(macOS)* | sessions, approvals, questions and Mochi on your iPhone | Settings → General → iPhone · your private iCloud, see [docs/IPHONE.md](docs/IPHONE.md) |
| **Android phone** *(Windows, Linux)* | sessions, approvals, questions and chat on your Android phone | Settings → Android phone · off by default, your local network only, see [android/README.md](android/README.md) |
| **Active pills** *(macOS)* | choose which tools and agents appear in the island | Settings → Active pills |
+| **Flow dictation** *(macOS, GitHub build)* | hold a key, speak, the words are pasted | Coucou → Flow → Settings · the Accessibility and Microphone permissions |
+| **Parakeet** *(macOS, Apple silicon)* | offline dictation, more accurate | Coucou → Flow → Settings → Recognition → **Download** (about 650 MB) |
| Stripe, n8n, GitHub, Vercel, Resend, Notion, Cal.com | the service pills | Keychain / Windows Credential Manager / Secret Service, all optional |
If Coucou isn't running, the hook exits immediately: **Claude Code is never blocked.**
### Supported agents
-| Agent | How it connects | Mac-only? |
+| Agent | How it connects (Mac) | Mac-only? |
|---|---|---|
| Claude Code | Settings → Claude Code → **Install hooks** | No |
-| Gemini CLI | Settings → Gemini CLI → **Install hooks** | Mac only |
-| Antigravity | Settings → Antigravity → **Install hooks** | Mac only |
+| Gemini CLI | Settings → Gemini CLI → **Install hooks** | No |
+| Antigravity | Settings → Antigravity → **Install hooks** | No |
| Cursor | Hooks installed automatically alongside Claude Code | No |
| Codex | `--agent codex` flag; Settings → Codex → **Install hooks** | No |
| Copilot CLI | `--agent copilot` flag + camelCase events | No |
| Muse Code | `--agent muse` flag | No |
-| OpenCode | Plugin — **Settings → OpenCode Plugin → Install** | Mac only |
-| Amp | Plugin — **Settings → Amp Plugin → Install** | Mac only |
-| Hermes | Plugin — **Settings → Agents → Hermes → Install** | Mac only |
+| OpenCode | Plugin — **Settings → OpenCode Plugin → Install** | No |
+| Amp | Plugin — **Settings → Amp Plugin → Install** | No |
+| Hermes | Plugin — **Settings → Agents → Hermes → Install** | No |
| Any other | `--agent <name>` flag; see [`docs/AGENTS.md`](docs/AGENTS.md) | No |
OpenCode, Amp and Hermes use a plugin model rather than a hook command. Coucou installs the plugin file into `~/.config/opencode/plugins/`, `~/.config/amp/plugins/` and `~/.hermes/plugins/coucou/` respectively. On Windows and Linux the plugins start the `coucou-hook` relay directly — see [`windows/README.md`](windows/README.md#supported-agents).
@@ -319,6 +349,8 @@ OpenCode, Amp and Hermes use a plugin model rather than a hook command. Coucou i
| Drag Mochi onto a window *(macOS)* | attaches it as context |
| Click the model name above the chat box *(macOS)* | switch AI provider or model |
| Say « OK Coucou, play some music » *(macOS)* | listens, thinks, and does it |
+| Hold right ⌥ and speak, in any app *(macOS)* | Mochi listens in the pill, your words are pasted |
+| Hover the pill at the bottom of the screen *(macOS)* | opens a toolbar: dictate, record a call, open Coucou |
## How it works
diff --git a/docs/media/hub-dictation.png b/docs/media/hub-dictation.png
new file mode 100644
index 00000000..ecd9d947
Binary files /dev/null and b/docs/media/hub-dictation.png differ
diff --git a/docs/media/hub-settings.png b/docs/media/hub-settings.png
new file mode 100644
index 00000000..793d7da2
Binary files /dev/null and b/docs/media/hub-settings.png differ
diff --git a/docs/media/hub-statistics.png b/docs/media/hub-statistics.png
new file mode 100644
index 00000000..be029976
Binary files /dev/null and b/docs/media/hub-statistics.png differ
diff --git a/docs/media/hub-styles.png b/docs/media/hub-styles.png
new file mode 100644
index 00000000..212ec6ae
Binary files /dev/null and b/docs/media/hub-styles.png differ