WinkoDocs

Winko documentation

Winko 文档

Winko 是 macOS 上的 AI Agent 状态信号灯。它把多个编程助手的运行、等待、完成和错误状态，翻译成一眼就能读懂的桌面灯语。

Winko 是什么

Winko 在本机监控已支持的 AI 工具，将事件先转换为语义状态，再显示为绿、黄、红等桌面信号。你可以使用软件悬浮窗，也可以连接支持的实体信号灯。

本地优先

Winko 不要求注册账号，状态监控和灯语聚合在你的 Mac 上完成。

快速开始

  1. 前往 GitHub Releases 下载最新的 macOS Universal DMG。
  2. 将 Winko 移入“应用程序”并打开，按首次引导完成本地 Hook 安装。
  3. 在设置中启用需要监控的来源，然后开始一个 AI Agent 任务。

开发者和高级用户可在 GitHub README 查看配置、本地状态 API 和构建说明。

支持的软件

当前可监控 CatDesk、Claude Code、Codex、Cursor、Z Code 和 OpenCode。不同软件通过本地 Hook、日志、会话文件或本机状态流接入。

Claude Code 可以在 Winko 中显示决策弹窗并把用户选择返回本地 Hook。Codex 只提醒你回到 Codex 处理，Winko 不代替你做审批决策。