Coucou：钻进你 Mac 刘海里的小精灵，帮你盯着所有 AI 编程智能体

几个设计工作室晒出过精致的「刘海小宠物」概念视频，然后就没有然后了。开源项目 Coucou 想做的是把这件事真正做出来——它用一个住在屏幕顶部的小角色，实时盯住你所有正在跑的 AI 编程智能体会话。项目 2026 年 9 月 27 日建仓，一周左右冲到 2900+ 星，MIT 协议开源。

它长这样：一只名叫 Mochi 的圆滚滚小方块（squircle）从刘海（刘海屏 MacBook）里探出头来，会跟你打招呼、眼睛跟着鼠标转、被戳多了会生气甚至头晕。但当 Claude Code 需要你确认权限的那一刻，它会第一时间提醒你。

它到底解决什么问题

现在多数人跑 AI 编程智能体，都是把 Claude Code、Cursor、Codex 这类工具丢在一个终端里，然后去干别的。问题是：智能体经常在中途停下来等你——要你批准一条命令、回答一个问题，或者报了个错。你不盯着那个窗口，整条流水线就卡在那里。

Coucou 把「盯窗口」这件事从你身上挪到了刘海上。智能体一有动静，Mochi 就在屏幕顶部冒出来告诉你。你甚至不用切窗口，直接在刘海卡片上点 Allow / Deny 就能放行。

核心功能

• 多智能体实时可见：Claude Code、Codex、Cursor、Gemini CLI、Antigravity 的会话都能显示在刘海里，读文件、改代码、跑命令，一步一步看得见。会话跑完，Mochi 还会开心地跳一下。
• 在刘海里批准权限：Claude Code 和 Codex 的权限请求会直接以 Allow / Deny（Claude Code 还有 Always）的形式弹出来，在 VS Code、Cursor 终端或 Codex 里都一样。点一下就继续干活。
• 跳回对应终端：macOS 上可以直接打开某个会话所在的终端窗口，不用再翻半天。
• 内置聊天：可以直接和 Claude、Gemini、OpenAI，或本地模型（Ollama / LM Studio）对话。点聊天框上方的模型名就能切换服务商和模型；云服务用自己的 API Key，本地模型连本机服务。
• Claude 套餐用量：macOS 刘海头部的小药丸会显示你 Claude 套餐的 5 小时 / 每周限额（Pro、Max 套餐）。
• 拖文件进刘海：Mochi 会变成一个盒子把文件「吞」下去，然后你可以就这个文件提问，或直接邮件发出去。
• 把 Mochi 拖到任意窗口上：把那个窗口挂载成 Claude 的上下文（macOS）。
• 服务集成：Stripe 支付、n8n 工作流、GitHub、Vercel 部署、Resend 邮件、Notion、Cal.com，每个服务都会分到一只自己颜色的小 Mochi。
• 真正的「角色感」：呼吸、眨眼、眼球投射在球面上跟随鼠标、各种表情，外加 28 个手工调制的音效，启动还有问候动画。
• 空闲时隐身：没有任务时它会藏起来，鼠标移到刘海上（Windows / Linux 是屏幕顶边）才探头。

技术实现：原生 Swift，零第三方依赖

macOS 版本是纯正的 Swift 6 / SwiftUI / AppKit，而且没有任何第三方依赖。几个细节挺值得一看：

• 岛屿本身：一个贴着刘海的「无边框 NSPanel」，由一个小状态机（hidden → petit → home）驱动。
• 角色动画：完全用 SwiftUI 的 Canvas + TimelineView 以 60fps 手绘——方块身体、投射到球面上的眼睛、弹簧动画。没有 Rive、没有 Lottie、不加载图片。
• Claude Code 接入：一个叫 nb-hook 的小脚本接收 hook 事件，通过 Unix socket 转发给 App；需要批准时它会等你点完，再把结果回给 hook。
• PillCatalog：PillCatalog.swift 是唯一事实来源，每个药丸（编程工具、智能体、AI 服务商、服务集成）都在这里声明自己的 ID、颜色和分类。
• 关键安全设计：如果 Coucou 没在运行，hook 会立刻退出——Claude Code 永远不会被卡住。

Windows 和 Linux 版本则是 Tauri 2（Rust + TypeScript）写的：岛屿是一个透明、永远置顶、且从不抢焦点的窗口，Mochi 用 Canvas 2D 画出与 Mac 上一致的形状、节奏和音效；Claude Code hook 走 coucou-hook.exe 加命名管道，密钥存在 Windows 凭据管理器里。Linux 侧复用同一套 Tauri 应用，Wayland 下岛屿是 gtk-layer-shell 叠加层，密钥存进 Secret Service。

安装

macOS（15+）：从 Releases 下载最新的 Coucou.zip，解压后把 Coucou.app 拖进 /Applications 启动即可。0.1.1 起已经用 Developer ID 签名并通过 Apple 公证，首次启动不用再去「系统设置」里点「仍要打开」了。

Windows：官方安装包暂时下架——Microsoft Defender 误判这个未签名安装包为恶意软件，误报申诉正在处理中，等清掉并签名后会恢复。目前只能从源码构建。PC 上没有刘海，所以岛屿是从屏幕顶边滑出来的。

Linux（beta）：首个 Linux 构建已放出，目前只有 x86_64。AppImage 用 chmod +x 后直接运行，Debian / Ubuntu 用 sudo apt install ./Coucou-Linux-*.deb，Fedora / openSUSE 用 sudo dnf install ./Coucou-Linux-*.rpm。

从源码构建 macOS 版本：

brew install xcodegen
git clone https://github.com/Louis-CFM/coucou.git
cd coucou/NotchBuddy
xcodegen
open NotchBuddy.xcodeproj   # 然后按 ⌘R

配置：会先给你看 diff，再动你的配置文件

点菜单栏（或系统托盘）里的 Coucou 图标 → Settings…。几个值得注意的点：

• 安装 Claude Code hooks：Coucou 会先备份 ~/.claude/settings.json，把它的 hooks 合并进去，并且写之前把 diff 给你看。
• API Key：Anthropic / Google AI / OpenAI 的 Key 都进 Keychain（Windows 是凭据管理器，Linux 是 Secret Service），不落明文。
• 本地模型：Ollama 或 LM Studio 在 Settings → Chat → Local models 里点 Connect 连上本机服务即可。
• 自定义智能体：任何智能体只要在 hook payload 上打个 coucou_agent 标记，就能在岛屿里拿到自己的药丸。

版本节奏

项目迭代很快，短短几天从 0.1.0 走到 0.1.2：

关于开源协议，有一点要注意

代码采用 MIT，随便用、随便 fork、随便学，保留版权声明即可。但 项目名、Mochi 角色形象、图标、音效和媒体素材是「保留所有权利」（见 LICENSE-ASSETS.md）。如果你想基于它做自己的发行版，记得换一个名字和自己的角色形象。

小结

Coucou 的聪明之处在于它挑对了「显示器」——不是再开一个网页仪表盘，而是利用你本来就有、却一直浪费的刘海空间。对每天要同时盯着好几个 AI 编程智能体的人来说，「权限请求主动来找你，而不是你去轮询窗口」这个体验差别很大。而它的实现方式（原生 Swift、零依赖、手绘角色、hook 不阻塞宿主）也说明作者确实懂 AI 编程工具链的实际痛点。

如果你平时就让 Claude Code、Codex、Cursor 这类工具在后台跑活儿，这个小精灵值得装一个试试。

项目地址：https://github.com/Louis-CFM/coucou