coucou

在刘海和锁屏盯住 AI 代理，抬手就能批准操作

开源 🏷️完全免费 ⏳ 访问状态待核验编程开发 🍴 复刻 965 🐛 待处理 442 👀 关注 48

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 5718

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源免费项目，定价信息待确认

项目预览

项目数据

分类编程开发

开发团队Louis-CFM

官网地址https://louis-cfm.github.io/coucou

GitHubhttps://github.com/Louis-CFM/coucou

定价模式🏷️完全免费

价格说明开源免费项目，定价信息待确认

访问状态⏳ 访问状态待核验

是否开源是

开源协议MIT

主要语言Swift

技术栈/模型ai-agents,anthropic,antigravity,claude,claude-code,codex,cursor,dynamic-island,gemini-cli,ios,iphon,linux,macos,macos-app,menubar-app,notch,open-source,swift,swiftui,windows

GitHub 星标★ 5718

上线时间2026-09-27 00:00:00

代码更新2026-10-20

仓库体积22.8 MB

本站数据更新2026-10-22

维护状态活跃

收录时间2026-10-22

浏览次数0

项目介绍

coucou 是一个用 Swift 编写的 macOS 与 iOS 小工具，把 AI 编程代理的状态监控搬到 Mac 刘海和 iPhone 灵动岛/锁屏上。它解决的是开发者同时运行 Claude Code、Codex、Cursor、Gemini CLI、Antigravity 等多个 AI 编码代理时，需要不断切窗口确认任务是否完成、是否等待授权的问题。核心能力包括：实时显示各代理运行状态与进度，在刘海或锁屏直接批准/拒绝代理发起的操作请求，减少上下文切换；支持多代理并行监控，并覆盖 macOS 与 iPhone 两端。项目体量小、原生体验好，适合重度使用 AI 编码代理的开发者。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-10-22 · 当前星标 ★ 5718

技术标签

ai-agents anthropic antigravity claude claude-code

使用教程

⚠ 本教程由 AI 依据该项目 README 整理；原始文档不完整，部分步骤为通用流程推断，实际安装请以项目官方文档为准。

难度：入门约 10 分钟部署方式：本地安装 8 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

macOS（Flow 听写、Parakeet 离线识别等特性仅 macOS 提供）
Windows 或 Linux 也可运行，通过系统托盘打开设置
Parakeet 离线听写需 Apple silicon，模型约 650 MB
已安装 Claude Code / Gemini CLI / Antigravity(agy) 等 AI 编码代理（按需）
可选：Anthropic / Google AI / OpenAI API key，或本地 Ollama、LM Studio 服务

安装与启动步骤

1安装并打开应用

README 的 Install 一节为空，未给出下载或安装命令。安装后从 Dock 或菜单栏打开 Coucou；0.4 起它是带独立窗口的 Mac 应用。
2进入设置面板

macOS 在应用内按 ⌘, 打开设置，所有选项都在 Notch 分组；Windows / Linux 点击托盘 Coucou 图标 → Settings…。
3安装 Claude Code hooks

这是实时会话与授权批准的前提。点击 Install hooks，Coucou 会先备份 ~/.claude/settings.json，合并 hooks 并在写入前展示 diff。
4安装其他代理 hooks

按需在 Settings → Gemini CLI 安装 hooks（备份 ~/.gemini/settings.json）；Settings → Antigravity 安装 hooks（备份 ~/.gemini/config/hooks
5填入 API key

需要聊天或询问文件时配置：Settings → Anthropic API 填 key；Google AI / OpenAI 在 Settings → Chat — other providers。密钥存入系统钥匙串。
6连接本地模型（可选）

Settings → Chat → Local models → Connect，可分别连接本机运行的 Ollama 或 LM Studio 服务。
7手机端配对（可选）

macOS 上 Settings → General → iPhone，经你自己的私有 iCloud 同步会话、授权与提问；Windows/Linux 侧 Settings → Android phone，默认关闭且仅走局域网。
8开启 Flow 听写（可选）

macOS 需在 Coucou → Flow → Settings 授予「辅助功能」和「麦克风」权限；如需更高准确率的离线识别，在 Recognition 里下载 Parakeet 模型。

关键配置

配置项	必填	说明	示例
`~/.claude/settings.json`	是	Claude Code hooks 写入位置，写入前会自动备份并展示 diff	`~/.claude/settings.json`
`~/.gemini/settings.json`	否	Gemini CLI hooks 写入位置，安装前自动备份	`~/.gemini/settings.json`
`~/.gemini/config/hooks.json`	否	Antigravity(agy) hooks 写入位置，安装前自动备份	`~/.gemini/config/hooks.json`
`Anthropic API key`	否	用于聊天与询问文件，存放于钥匙串/凭据管理器	`sk-ant-xxxxxxxx`
`Google AI / OpenAI API key`	否	macOS 上在 Chat — other providers 中配置其他聊天提供方	`sk-xxxxxxxx`

如何确认成功

刘海或屏幕顶部（手机端为锁屏/灵动岛）出现 Mochi 并显示代理会话；触发一次代理授权请求，可直接在刘海或锁屏上批准或拒绝。

常见问题

Q：Coucou 没运行时，hooks 会阻塞 Claude Code 吗？

A：不会。README 明确说明：如果 Coucou 未运行，hook 会立即退出，Claude Code 永远不会被阻塞。

Q：为什么看不到会话或授权提示？

A：多半是没装对应 hooks。到 Settings 里为 Claude Code、Gemini CLI、Antigravity 分别点 Install hooks，然后查看写入前后的 diff 确认已合并。

Q：安装 hooks 会改坏我原来的配置吗？

A：Coucou 会先备份原始 settings.json，再合并自己的 hooks，并在真正写入前把 diff 展示给你确认。

Q：离线听写需要什么条件？

A：需 macOS + Apple silicon，在 Flow → Settings → Recognition 里下载 Parakeet 模型，约 650 MB。

Q：API key 存在哪里？

A：macOS 存钥匙串（Keychain），Windows 存凭据管理器，Linux 存 Secret Service，不写进明文配置文件。

注意事项

README 的 Install 章节为空，未提供任何下载链接或安装命令，本教程仅依据其 Setup 章节整理，具体获取方式请以官网和仓库发布页为准。
项目为 MIT 许可开源，但 Coucou 名称、Mochi 形象与音效版权归作者所有。
Android 手机连接默认关闭，且仅在你自己的局域网内通信。
各类服务提示（Stripe、n8n、GitHub、Vercel、Resend、Notion、Cal.com）以及 WhatsApp 集成都属可选项。

核心亮点

把 AI 代理状态和授权操作放到刘海/锁屏，无需切窗口，减少打断
原生 Swift 实现，macOS 与 iOS 双端一致体验，轻量不臃肿
覆盖 Claude Code、Codex、Cursor、Gemini CLI、Antigravity 等多种主流代理

不足之处

强依赖 macOS 刘海与 iOS 灵动岛/锁屏，设备与系统版本受限
对代理的监控与批准依赖各工具接口，新代理或版本变动可能适配滞后

适用场景

同时跑多个 AI 编码代理时，在刘海一眼看进度并直接批准操作
离开工位后用 iPhone 锁屏接收代理完成或待授权提醒
用 Cursor/Claude Code 写代码时避免频繁切终端确认状态

替代项目

Claude Code、Aider

上一篇：run

下一篇：没有了！