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.

Windows: installer, release workflow and README

Louis Raille6ace8e2dedbf
diff --git a/.github/workflows/windows.yml b/.github/workflows/windows.yml
new file mode 100644
index 00000000..76986ea1
--- /dev/null
+++ b/.github/workflows/windows.yml
@@ -0,0 +1,104 @@
+name: Windows
+
+# Builds the Windows app and publishes the installer.
+# Triggered by tags like `windows-v0.1.0`; the macOS workflows are untouched.
+
+on:
+ push:
+ tags:
+ - 'windows-v*'
+ workflow_dispatch:
+
+permissions:
+ contents: write
+
+jobs:
+ build:
+ runs-on: windows-latest
+ defaults:
+ run:
+ working-directory: windows
+
+ steps:
+ - uses: actions/checkout@v4
+
+ - uses: actions/setup-node@v4
+ with:
+ node-version: 22
+ cache: npm
+ cache-dependency-path: windows/package-lock.json
+
+ - name: Cache cargo
+ uses: actions/cache@v4
+ with:
+ path: |
+ ~/.cargo/registry
+ ~/.cargo/git
+ windows/target
+ key: windows-cargo-${{ hashFiles('windows/Cargo.lock') }}
+ restore-keys: windows-cargo-
+
+ - name: Install dependencies
+ run: npm ci
+
+ # `npm run build` (run by tauri as beforeBuildCommand) builds coucou-hook
+ # first, which tauri.conf.json then bundles as a resource.
+ - name: Build the installer
+ run: npm run tauri build
+
+ - name: Name the installer
+ id: pack
+ shell: pwsh
+ run: |
+ $version = "${{ github.ref_name }}" -replace '^windows-v', ''
+ if (-not $version) { $version = (Get-Content src-tauri/tauri.conf.json | ConvertFrom-Json).version }
+ $built = Get-ChildItem target/release/bundle/nsis/*-setup.exe | Select-Object -First 1
+ if (-not $built) { throw "no NSIS installer was produced" }
+ New-Item -ItemType Directory -Force out | Out-Null
+ Copy-Item $built "out/Coucou-Windows-$version-setup.exe"
+ Copy-Item $built "out/Coucou-Windows-setup.exe"
+ "version=$version" >> $env:GITHUB_OUTPUT
+ Get-ChildItem out | Format-Table Name, Length
+
+ - uses: actions/upload-artifact@v4
+ with:
+ name: Coucou-Windows-setup
+ path: windows/out/Coucou-Windows-${{ steps.pack.outputs.version }}-setup.exe
+
+ - name: Publish the release
+ if: startsWith(github.ref, 'refs/tags/windows-v')
+ shell: pwsh
+ env:
+ GH_TOKEN: ${{ github.token }}
+ run: |
+ $v = "${{ steps.pack.outputs.version }}"
+ $notes = @"
+ Coucou for Windows $v — Mochi at the top of your screen.
+
+ Download ``Coucou-Windows-$v-setup.exe`` and run it. The installer is not
+ code-signed yet, so Windows SmartScreen shows a warning: click
+ **More info → Run anyway**.
+ "@
+ gh release create "${{ github.ref_name }}" `
+ "out/Coucou-Windows-$v-setup.exe" `
+ --title "Coucou for Windows $v" `
+ --notes $notes
+
+ - name: Update the rolling windows-latest release
+ if: startsWith(github.ref, 'refs/tags/windows-v')
+ shell: pwsh
+ env:
+ GH_TOKEN: ${{ github.token }}
+ run: |
+ $v = "${{ steps.pack.outputs.version }}"
+ $exists = gh release view windows-latest 2>$null
+ if ($LASTEXITCODE -eq 0) {
+ gh release edit windows-latest --title "Coucou for Windows (latest)" --notes "Always the newest Windows build — currently $v."
+ gh release upload windows-latest "out/Coucou-Windows-setup.exe" --clobber
+ } else {
+ gh release create windows-latest `
+ "out/Coucou-Windows-setup.exe" `
+ --title "Coucou for Windows (latest)" `
+ --notes "Always the newest Windows build — currently $v." `
+ --latest=false
+ }
diff --git a/windows/.gitignore b/windows/.gitignore
index 49947288..25a86a8b 100644
--- a/windows/.gitignore
+++ b/windows/.gitignore
@@ -1,6 +1,7 @@
node_modules/
dist/
target/
+out/
*.tsbuildinfo
# Generated by tauri-build on every compile
diff --git a/windows/README.md b/windows/README.md
new file mode 100644
index 00000000..3a4db847
--- /dev/null
+++ b/windows/README.md
@@ -0,0 +1,137 @@
+<div align="center">
+
+<img src="src-tauri/icons/128x128.png" width="96" alt="Coucou icon">
+
+# Coucou for Windows
+
+**Mochi doesn't get a notch on a PC — so it lives at the top of your screen instead.**
+
+Approve Claude Code permissions, watch your session work, drop a file, chat with Claude, keep an eye on your services — without leaving what you're doing.
+
+![Windows 10/11](https://img.shields.io/badge/Windows-10%2F11-0078D4?logo=windows)
+![Tauri 2](https://img.shields.io/badge/Tauri-2-FFC131?logo=tauri&logoColor=black)
+![Rust](https://img.shields.io/badge/Rust-backend-000?logo=rust)
+![License: MIT](https://img.shields.io/badge/license-MIT-green)
+
+</div>
+
+<img src="screenshots/greeting.png" width="640" alt="Mochi waving hello at launch">
+
+---
+
+## Install
+
+1. Download `Coucou-Windows-setup.exe` from the [latest release](../../releases/tag/windows-latest).
+2. Run it. It installs for the current user only — no admin prompt.
+3. Coucou starts, waves hello, and then gets out of the way.
+
+### "Windows protected your PC"
+
+The installer isn't code-signed yet, so **SmartScreen** shows a blue warning the first
+few times anybody downloads it:
+
+> Windows protected your PC — Microsoft Defender SmartScreen prevented an unrecognised app from starting.
+
+Click **More info**, then **Run anyway**. That's it. Signing is on the list; until
+then this is what an unsigned installer looks like on Windows, and you can always
+[build it yourself](#build-it-yourself) if you'd rather not trust a download.
+
+## Using it
+
+<img src="screenshots/compact.png" width="308" alt="The compact island">
+<img src="screenshots/approval.png" width="640" alt="A Claude Code permission request, with Deny, Allow and Always">
+<img src="screenshots/chat.png" width="640" alt="Chatting with Claude from the island">
+<img src="screenshots/drop.png" width="640" alt="Mochi turned into a box, waiting for a file">
+
+| What you do | What happens |
+|---|---|
+| Move the mouse to the very top-centre of the screen | Mochi peeks out |
+| Click the small island | It opens |
+| Click Mochi | It gets annoyed. Three times in a row and it goes dizzy |
+| Rest the pointer on Mochi for two seconds | Hearts |
+| Drag a file onto the island | Mochi turns into a box, swallows it, then offers to answer questions about it |
+| `Esc` | Closes the island |
+| Tray icon | Open, Settings…, Pause, Quit |
+
+Everything else happens on its own: a Claude Code permission request opens the
+island with **Deny / Allow / Always**, a finished session shows what it did, and
+your integrations sit in the coloured pills next to Mochi.
+
+## Claude Code
+
+<img src="screenshots/settings.png" width="562" alt="The settings window">
+
+Open **Settings… → Claude Code → Install hooks…**. You get the exact diff of what
+will change in `%USERPROFILE%\.claude\settings.json`, the path of the dated backup
+that will be taken, and nothing is written until you click. Your own hooks are
+never touched, and uninstalling removes only Coucou's entries.
+
+The relay is a tiny executable, `coucou-hook.exe`, copied to
+`%LOCALAPPDATA%\Coucou\bin\` at launch. It is given 300 ms to reach Coucou and
+exits cleanly if the app is closed, slow or crashed — **a Claude Code session is
+never blocked or slowed down by Coucou.** If nobody answers a permission request
+in time, Coucou stays quiet and Claude Code asks in the terminal as usual.
+
+It works from any terminal — Windows Terminal, PowerShell, VS Code, Git Bash.
+
+## Chat and keys
+
+**Settings… → Claude** takes your Anthropic API key. Keys live in the **Windows
+Credential Manager**, never on disk and never in the interface — the island can
+only ask whether a key exists. Same for every integration key.
+
+No telemetry. The only network requests Coucou makes are to the services you
+configure yourself.
+
+## Build it yourself
+
+You need [Rust](https://rustup.rs), [Node 20+](https://nodejs.org), and the
+**MSVC build tools** (Visual Studio Build Tools with "Desktop development with
+C++"). WebView2 ships with Windows 10/11.
+
+```powershell
+cd windows
+npm install
+npm run tauri dev # live-reloading development build
+npm run tauri build # installer in target/release/bundle/nsis/
+```
+
+The 28 sounds are the macOS app's own files; they are never duplicated in this
+folder. The path is declared once, in `SOUNDS_DIR` at the top of
+`vite.config.ts` — when they move to `shared/sounds/`, change that one line.
+
+The app icon and the tray icon are drawn in code, like Mochi itself:
+
+```powershell
+npm run icons # regenerates src-tauri/icons from scripts/gen-icons.mjs
+```
+
+### Layout
+
+```
+windows/
+ src/ island front end (TypeScript, no framework)
+ mochi/ Mochi and the launch greeting, in Canvas 2D
+ island/ state machine, hooks, integrations
+ views/ every island view
+ settings/ the settings window
+ src-tauri/ Rust backend: window, named pipe, Claude API, pollers
+ hook/ coucou-hook.exe, the Claude Code relay
+ scripts/ icon generator
+```
+
+### Log
+
+`%LOCALAPPDATA%\Coucou\coucou.log` — hook events, permission decisions, poller
+problems. It stays on your machine.
+
+## What's different from the Mac version
+
+- No notch, so the island lives at the top centre of the screen and retracts into
+ the top edge instead of hiding in a notch.
+- Permission approval works from **any** terminal; the Mac build only listens to
+ VS Code sessions.
+- Not in this version: sending a file by email, dragging Mochi onto a window to
+ attach it as context, and jumping to a specific terminal window — "Open
+ terminal" opens the working folder in VS Code when `code` is on your `PATH`.
+- Cal.com shows the next bookings as a list rather than the Mac's calendar.
diff --git a/windows/screenshots/approval.png b/windows/screenshots/approval.png
new file mode 100644
index 00000000..af3d0bdc
Binary files /dev/null and b/windows/screenshots/approval.png differ
diff --git a/windows/screenshots/chat.png b/windows/screenshots/chat.png
new file mode 100644
index 00000000..3b22dd88
Binary files /dev/null and b/windows/screenshots/chat.png differ
diff --git a/windows/screenshots/compact.png b/windows/screenshots/compact.png
new file mode 100644
index 00000000..a99cd605
Binary files /dev/null and b/windows/screenshots/compact.png differ
diff --git a/windows/screenshots/drop.png b/windows/screenshots/drop.png
new file mode 100644
index 00000000..65d53dfc
Binary files /dev/null and b/windows/screenshots/drop.png differ
diff --git a/windows/screenshots/greeting.png b/windows/screenshots/greeting.png
new file mode 100644
index 00000000..6ea656a1
Binary files /dev/null and b/windows/screenshots/greeting.png differ
diff --git a/windows/screenshots/settings.png b/windows/screenshots/settings.png
new file mode 100644
index 00000000..496241b6
Binary files /dev/null and b/windows/screenshots/settings.png differ
diff --git a/windows/src/views/integrations.ts b/windows/src/views/integrations.ts
index 1bbd53c8..b8ad73c8 100644
--- a/windows/src/views/integrations.ts
+++ b/windows/src/views/integrations.ts
@@ -57,7 +57,10 @@ function idleCard(task: AgentTask, openSettings: () => void): HTMLElement {
const info = State.integrations[task.id];
const configured = info?.configured ?? false;
const error = info?.error ?? null;
- const label = error ?? (configured ? "Connected · loading…" : "Key not configured");
+ // The Claude Code pill is about hooks, not a key — the macOS wording would be
+ // misleading here.
+ const missing = task.id === "integration_claude" ? "Hooks not installed" : "Key not configured";
+ const label = error ?? (configured ? "Connected · loading…" : missing);
const statusColor = error || !configured ? "#F4505E" : "#22C55E";
const actions = h("div", { class: "int-actions" });