Clawd on Desk —— 感知 AI 编程助手状态的桌面宠物（支持 CC / Codex / Copilot / Gemini / Cursor）

背景

随着 AI 编程助手（如 Claude Code、Codex CLI、Copilot 等）在日常开发中越来越普及，开发者面临一个新问题：这些助手在终端中输出大量文本，用户很难直观判断其当前状态——是在思考、执行工具调用，还是已经完成。传统做法是不断切回终端窗口查看，打断了工作流。基于这一痛点，开发者 rullerzhou-afk 于今年 3 月初开始构建 Clawd on Desk，一个运行在桌面上的像素宠物，通过视觉动画实时反映 AI 编程助手的活动状态，让开发者只需余光一扫即可掌握助手进展。项目发布后受到社区欢迎，目前在 GitHub 上获得 650+ Stars，有十几位贡献者参与迭代。

核心内容

Clawd on Desk 是一个跨平台桌面宠物应用，支持 Windows 11、macOS 和 Linux，需要 Node.js 环境。它通过 Hook 或轮询方式接入主流 AI 编程助手，独立追踪每个会话，并实时显示对应状态动画。

支持的 AI Agent 与接入方式

| Agent | 接入方式 | 配置难度 | |-------|----------|----------| | Claude Code | 命令 hook + HTTP 权限 hook | 开箱即用，启动自动注册 | | Codex CLI | JSONL 日志轮询 | 免配置 | | Copilot CLI | 命令 hook | 手动配置 | | Gemini CLI | 命令 hook | 启动自动注册 | | Cursor Agent | Cursor IDE hook | 启动自动注册 |

所有 Agent 可同时运行，Clawd 独立追踪每个会话，互不干扰。

动画状态系统

核心状态有 8 种：空闲、思考、打字、杂耍、建造、报错、开心、睡觉。此外还包括读书、debug 巡逻、指挥（2+ 子代理）、扫地（内存整理）、搬箱子（工作树创建）、通知惊跳等动画，总计 12 种状态 + 多个空闲随机动画。每个状态对应助手在终端中的实际活动（如思考、运行工具、报错等）。

权限审批气泡（核心功能）

当 Claude Code 请求权限（如读取文件、执行命令）时，Clawd 会在桌面直接弹出毛玻璃风格卡片，提供 Allow / Deny / 建议规则三个选项，用户无需切回终端即可审批。支持全局快捷键：Ctrl+Shift+Y 允许，Ctrl+Shift+N 拒绝。多个权限请求会从右下角向上堆叠显示。如果终端先回答了，气泡自动关闭。这一功能大幅减少了窗口切换操作。

眼球追踪与交互彩蛋

空闲时，Clawd 的眼睛会跟随光标移动，身体有倾斜和影子拉伸效果。双击戳一下，连点 4 次触发抓狂反应，反复戳有不同反馈。支持从任何状态直接拖拽（使用 Pointer Capture 防止甩脱）。

迷你模式

将 Clawd 拖到屏幕右边缘会自动缩小，悬停时探头打招呼。收起状态下仍显示迷你通知和庆祝动画。

多会话智能

多个会话同时存在时，显示最高优先级状态。右键菜单提供会话列表，可直接跳转到对应终端窗口。检测到崩溃或退出的 Agent 进程时，自动清理孤儿会话。Clawd 重启时如果检测到有 Agent 仍在运行，会保持清醒不会进入睡眠状态。

Remote SSH 支持

一键部署到远程服务器，权限审批气泡可通过 SSH 反向端口转发回本地桌面。无需修改 Clawd 代码，Claude Code 和 Codex CLI 的远程事件能穿越 SSH 隧道。

其他功能

• 免打扰模式：右键进入睡眠，所有 hook 事件静默
• 音效：任务完成和权限请求时播放短音效（可关闭，10 秒冷却，DND 自动静音）
• 权限模式感知：实时跟踪 Claude Code 当前权限模式，切换时弹通知
• 自动更新：Windows 使用 NSIS 更新，macOS/Linux 使用 git pull + 自动重启
• 国际化（i18n）：中英双语，右键菜单切换
• 系统托盘：调整大小（S/M/L）、DND、语言、自启动、检查更新

正在开发

多主题皮肤替换，允许自定义角色外观和动画风格。

快速开始

git clone https://github.com/rullerzhou-afk/clawd-on-desk.git
cd clawd-on-desk
npm install
npm start

关键要点

• Clawd on Desk 通过 Hook 和轮询方式接入 5 种主流 AI 编程助手（Claude Code、Codex CLI、Copilot CLI、Gemini CLI、Cursor Agent），并支持同时运行多个会话
• 提供 12 种状态动画（包括思考、打字、报错等），与 AI 助手的实际活动一一对应，用户无需查看终端文本即可感知状态
• 权限审批气泡是核心工作流改进：在桌面弹窗审批权限，支持快捷键和堆叠显示，消除反复切回终端的需求
• 眼球追踪和交互彩蛋（戳、拖拽、抓狂等）增加了趣味性和用户粘性
• 迷你模式允许收缩到屏幕边缘，仍能显示通知和动画，不干扰主工作区
• 多会话智能管理：自动显示最高优先级状态，支持跳转到对应终端窗口，自动清理孤儿会话
• Remote SSH 支持使远程服务器上的 AI 助手状态也能在本地桌面展示，权限气泡可穿越 SSH 隧道
• 项目开源，使用 Node.js 开发，跨平台支持 Windows 11、macOS、Linux
• 已在 GitHub 获得 650+ Stars，有十几位贡献者，项目仍在积极开发中（多主题皮肤等）

意义与影响

Clawd on Desk 将 AI 编程助手的终端文本输出转化为直观的视觉反馈，解决了开发者难以实时感知助手状态的问题。其核心创新在于权限审批气泡——将原本需要手动切回终端完成的交互转移至桌面，显著减少了工作流中的中断次数。这一设计思路体现了「环境感知交互」的理念：让工具适应人的注意力模式，而非要求人主动监控工具。

从更广的视角看，该项目展示了 AI 辅助编程工具与用户界面深度融合的可能性。随着 Claude Code、Codex CLI 等 Agent 型工具越来越普遍，开发者需要更高效的状态感知和交互方式。Clawd on Desk 通过开源社区协作，快速迭代出多会话管理、远程 SSH 支持、国际化等实用功能，表明这类轻量级桌面辅助工具存在明确需求，且有潜力成为 AI 开发工作流的标准配置之一。

此外，项目的开源特性和社区参与模式（650+ Stars、十多位贡献者）也验证了围绕 AI 编程工具生态的插件/辅助工具价值。将来，随着更多 Agent 类型和自定义主题的支持，Clawd 可能演变成为一个通用的 AI 助手状态可视化框架，而不仅限于某个特定工具。