Claude Pet 是 Byteflow.bot 开发的免费开源桌面伴侣，专为使用 Claude Code 的开发者设计。Claude Code 在终端中运行，当用户切换到其他窗口时，往往不清楚 Claude 正在做什么。Claude Pet 通过一个小机器人吉祥物悬浮在屏幕右下角，实时响应 Claude Code 的钩子事件，用动画表情和声音让用户随时了解状态。
主要能力
实时状态反应：宠物根据 Claude Code 事件显示不同表情和声音，例如紫色旋转眼睛表示思考、青色扫描眼睛表示读取文件、蓝色闪光表示写入/编辑代码、绿色下箭头表示运行 bash 命令、绿色 ^^ 眼睛加三声短叮表示任务完成、红色 X 眼睛加低沉音表示任务失败、蓝色像素圆圈加两声哔表示需要用户注意、睡眠脸加 Zzz 表示空闲 3 分钟、星星眼表示新会话开始。
声音提醒：任务完成播放三声短叮，需要输入或权限时播放两声注意哔，失败播放低沉音，让用户即使离开终端也能通过声音知道何时需要返回。
本地图记忆（v0.3.0）：按项目存储决策、约定、修复和注意事项到 ~/.claude/claude-pet/memory.sqlite，数据完全本地，不同步、不打包。SessionStart 钩子会输出不超过 800 token 的排序上下文块（权重 × 新近度 × FTS5 匹配），让 Claude 在第一轮就能看到重要信息。如果存在 .ua/knowledge-graph.json（Understand-Anything 格式），会作为权威来源导入。
自学习技能：重复出现至少 2 次的模式会自动提升为 ~/.claude/claude-pet/skills/ 下的真实 SKILL.md 文件，带有有效 frontmatter，Claude Code 可自动识别。技能等级从 🥚 孵化 → 🐣 学徒 → 🦉 资深 → 🦄 大师 演进。
人体工学教练（v0.4.0）：根据 Claude Code 钩子事件计算实际工作时间，在合适时机提示微休息，并由宠物通过动画 SVG 演示动作，带倒计时环和完成/跳过按钮。包括每 20 分钟眼休息（20-20-20 法则）、每 30 分钟下巴内收、每 45 分钟手腕环绕、每 60 分钟伸展、每 60 分钟喝水提醒。计时器在宠物进入 3 分钟睡眠状态时暂停，打字时最多延迟 5 分钟，避免打断。配置位于 ~/.claude/claude-pet/config.json。注意：这不是医疗建议，仅为基于已发表人体工学研究的健康指导。
GitHub 仓库监控（v0.5.0）：可添加公开或私有仓库（私有需 token），宠物会在有新提交、PR 打开/合并/关闭、PR 评审（批准/请求更改/评论）、新发布、CI 运行（通过/失败/取消）、部署状态、新 issue 时发出通知。采用轮询而非 webhook，无需公网端点；使用 ETag 缓存，安静仓库首次轮询后不消耗速率限制；未认证每小时 60 次（5 个仓库 5 分钟间隔足够），使用个人访问令牌每小时 5000 次；首次轮询静默，只提醒添加后的活动；事件去重；可按类型开关。也可在仪表盘 GITHUB 标签页添加仓库。
使用方式
安装：提供一键安装脚本。Windows 使用 PowerShell，macOS 使用 bash install.command，Linux 使用 install.sh。也可下载最新 release ZIP，双击对应系统的安装文件（macOS 为 install.command，Windows 为 install.bat，Linux 为 install.sh），等待约 60 秒即可。macOS 还提供预构建的 Claude Pet.app，拖入 /Applications 双击即可，无需 Python。安装程序会检查 Python 3.10+、安装 Homebrew（macOS 如缺失）、安装 Cairo 图形库、创建 Python 虚拟环境、安装 claude-pet 包、将 Claude Code 钩子写入 ~/.claude/settings.json、后台启动吉祥物。安装程序幂等，可安全重复运行。
交互：点击吉祥物打开 HUD 仪表盘（Projects / Graph / Skills / Stats / Ergo 标签页）；拖动可移动位置；右键打开上下文菜单，包含 Hello / Working / Celebrate / Sleep（反应戳）、Take a break now（立即打开人体工学覆盖层）、Snooze breaks 30 min、Turn Ergonomics ON/OFF、Reset position / Quit。空闲 3 分钟后吉祥物入睡并暂停所有人体工学计时器；空闲期间每 30 秒短暂显示当前时间。吉祥物始终置顶于所有应用之上，包括全屏应用和 macOS 的其他空间。
更新：一条命令自动检测安装类型、拉取最新版并重启宠物。可编辑安装（git clone）会执行 git pull --ff-only 并刷新 pip；常规 pip 安装会执行 pip install --upgrade git+https://github.com/nikhilagrima/claude-pet.git 然后重启。幂等，已是最新会提示 already up to date，加 --force 可强制重装。
构建：使用 PyInstaller，不支持交叉编译，需在目标操作系统上构建。
适用场景
适合使用 Claude Code 进行开发、希望在不盯着终端时也能感知 Claude 状态、需要项目级本地记忆和自动技能沉淀、关注人体工学健康、以及需要监控 GitHub 仓库活动的开发者。
限制与说明
系统要求：Python 3.10 或更新版本；macOS 11+（Big Sur 或更新）；Linux 需 X11 或 Wayland 合成器（GNOME、KDE、Sway 已测试）。Windows 支持情况在资料中未明确列出具体版本要求。
数据与隐私：100% 本地，无云、无嵌入、无向量数据库、无新守护进程。11 个秘密模式正则会在写入磁盘前脱敏敏感信息。.sqlite 文件已加入 .gitignore，包内附带全新空记忆。
声音：macOS 使用系统内置声音；Windows 回退到 Windows Notify System Generic.wav；Linux 使用 freedesktop 的 complete.oga / dialog-error.oga；若均未找到则播放捆绑的回退 WAV。
数据流：Claude Code 事件 → hook.py → HTTP POST 到 :5050 → 宠物轮询并渲染新表情。
许可：MIT © 2026 Byteflow.bot。
人体工学功能非医疗建议，不诊断或治疗任何状况，如有疼痛请咨询专业人士。
其他功能细节、收费情况、平台支持等资料未提供的信息暂未提供。
