Hermes Pets：给你的 Hermes Agent 配一只会汇报工作的桌面宠物

📝

开源项目 Hermes Pets（MIT），为 Hermes Agent 打造的本地桌面宠物伴侣——浮动 Electron 窗口实时反馈任务状态，工作完成/失败/需要关注时气泡通知。7 天迭代 4 个版本，支持 WSL/Windows，内置成就系统和自定义动画宠物。

项目：https://github.com/asimons81/hermes-pets

一句话总结

Hermes Pets 是专为 Hermes Agent 打造的本地桌面宠物助手——一个浮动在屏幕上的小型动画窗口，会实时反馈 Agent 的工作状态：任务开始、完成、失败、需要关注时自动弹出气泡通知，让长时间的终端编码更加可视化。

项目速览

维度	数据
Stars	64 ⭐
项目年龄	仅 7 天（2026-05-05 至今）
版本	v0.4.0（今日发布）
迭代速度	4 个版本 / 7 天 🔥
语言	Python + Electron
许可	MIT
平台	WSL2/Windows（主力）
Open Issues	6

核心理念

“让长时间的本地编程会话更有可读性和生命力”

Hermes Pets 不是为了”好玩”而做——它解决了一个实际痛点：Agent 在后台长时间运行时，你只能苦等终端输出。有了桌面宠物，任务状态一目了然：

✅ 工作完成 → 气泡："Tasks passed: 14"
❌ 工作失败 → 气泡："Build failed, check logs"
⏰ 需要审批 → 气泡："Approval needed: rm -rf..."
⚡ 空闲超时 → 宠物进入 idle 动画

架构

WSL Shell
  → hermes-pet launch
  → Python WebSocket Bridge (ws://127.0.0.1:17473)
  → Windows PowerShell 启动器
  → Electron 浮窗覆盖层 (Electron cache in %LOCALAPPDATA%)

核心命令

# 启动桌面宠物
hermes-pet launch
hermes-pet launch --replace     # 覆盖旧窗口

# 发送气泡通知
hermes-pet emit bubble "开始处理 PR #42"
hermes-pet message --from "CI" -- "构建通过"

# 包装命令（自动报告成功/失败）
hermes-pet wrap --name "Tests" -- pytest
hermes-pet wrap --name "Deploy" -- kubectl apply -f .

# 查看工作历史
hermes-pet jobs --last
hermes-pet brief --since 24h
hermes-pet brief --emit         # 将摘要发给宠物
hermes-pet brief --telegram-text # Telegram 友好格式

# 安静模式
hermes-pet quiet
hermes-pet mute 30m

v0.3.0 本地仪表盘

1	hermes-pet dashboard --no-open # 启动本地仪表盘

绑定 localhost + 每进程 token 认证（非公开服务）
内置面板：宠物状态、工作历史、通知偏好、语音预览、成就系统
支持切换/导入自定义动画宠物
成就系统（v0.3.0 基础版）：静默解锁，无彩带无弹窗

v0.4.0 更新亮点（今日发布）

专注于信任和更新安全——hermes-pet update 变得更安全：

--check：检查版本状态（不修改文件）
--dry-run：预览更新步骤（不执行）
仅 fast-forward（不 merge/rebase/stash）
脏工作树自动拦截
依赖刷新使用当前 Python/Electron 包管理器

自定义动画宠物

支持导入自定义精灵动画包：

hermes-pet custom-pet list
hermes-pet custom-pet validate <path>
hermes-pet custom-pet import <path> --name my-pet
hermes-pet custom-pet use my-pet
hermes-pet custom-pet preview <path> --output preview.html

动画要求：idle 状态必需，其他状态缺失时 fallback 到 idle。打包格式见 CUSTOM_PETS.md。

可选 Shell 别名

source shell-helpers/hermes-pet.bash
# hp → hermes-pet
# hpl → launch
# hpwrap "Name" -- cmd... → 包装命令
# hpbrief → 生成摘要
# hpmute → 静音 30min

适用场景

场景	使用方式
长时间 Agent 任务	`hermes-pet wrap --name "..." -- <cmd>` 自动报告
CI/CD 流水线	`hermes-pet emit bubble "Deploy stage 3/5 done"`
多人协作提醒	`hermes-pet message --from "@同事" -- "review PR #42"`
每日工作摘要	`hermes-pet brief --since 8h --emit`
Pomodoro 专注	`hermes-pet mute 25m → 5min 休息 → 重复`

评价

维度	评分	说明
创新性	⭐⭐⭐⭐	桌面宠物 + Agent 状态可视化的组合很新颖
生产力	⭐⭐⭐⭐	后台任务状态一目了然，不用频繁切终端
代码质量	⭐⭐⭐⭐	Python CLI + Electron + WebSocket 架构清晰
成熟度	⭐⭐	仅 7 天，v0.4.0 仍属于早期快速迭代阶段
文档	⭐⭐⭐⭐	README 详尽 + 操作指南 + smoke tests
跨平台	⭐⭐	主力 WSL/Windows，macOS/Linux 还在计划中

一句话：如果你用 Hermes Agent 且用 WSL/Windows，这只桌面宠物能让长时间编码变得不那么枯燥——它是 Tamagotchi 和终端监控的合体。7 天 4 个版本说明开发者很认真，但项目还很年轻，期待生态成熟。