FollowAgents AI AGENTS 目录
首页 / 全部 Agents / Claude Pet
开发与工程 desktop-companionproject-memorygithub-monitoringergonomics-coachingsound-notificationsdeveloper-dashboard

Claude Pet

用桌面宠物实时呈现 Claude Code 状态，并提供项目记忆、仓库提醒与工间休息指导。

在 GitHub 查看 ↗ 快速上手 ↓
源仓库
nikhilagrima/claude-pet
Star 数
★ 15
最近更新
3 个月前
License
MIT
主语言
Python
FA 评分
53/100 · 缺口较多

30 秒速览

运行形态
桌面应用命令行工具Agent 插件 / 技能
可在哪里用
平台专用Claude Code
费用
免费，无需付费服务
上手难度
中 · 需要几步配置
开始前需要
Python 3.10+Cairo 图形库macOS 11+、Windows 10+，或带 X11/Wayland 的 LinuxClaude Code用于私有仓库或更高 API 限额的 GitHub 个人访问令牌Shell / 命令行网络访问本地文件系统
典型场景
经常在 Claude Code 执行任务时切换到浏览器、Slack 或其他编辑器的开发者，可通过悬浮表情和声音判断任务正在思考、读写文件、运行命令、等待输入、完成或失败。
不适合
  • 不使用 Claude Code、只依赖 ChatGPT 或 Codex 的开发者
  • 不愿在本地常驻桌面窗口与 5050 端口 Flask 服务的团队
  • 需要完全离线或禁止写入 Claude 设置与本地 SQLite 的环境
源码审查
53/100 · 缺口较多

这个 Agent 能做什么，适合哪些场景？

Claude Pet 是面向 Claude Code 用户的本地桌面伴侣，而不是独立编写代码的通用代理。它通过 Claude Code hooks 接收会话、工具和失败等事件，由 hook.py 将事件发送至本机 :5050 Flask 服务，再由 PySide6 透明悬浮窗口渲染情绪动画并播放声音。它还把项目决策、约定、修复和备注保存在本地 SQLite 图谱中，并在新会话开始时注入不超过 800 token 的排序上下文。点击宠物可打开包含 Projects、Graph、Skills、Stats、Ergo 和 GitHub 功能的 HUD；命令行则用于生命周期、记忆、人体工学提醒和仓库监控。应用可监测 GitHub 提交、PR、评审、发布、Actions、部署及议题，但私有仓库和较高限额需要个人访问令牌。它适合希望离开终端时仍掌握 Claude Code 状态、并接受本地记忆与桌面常驻进程的开发者。

安装器检查 Python 3.10+、安装 Cairo、创建虚拟环境、安装 claude-pet，并向 ~/.claude/settings.json 写入 Claude Code hooks。事件链路为 Claude Code event → hook.py → HTTP POST 到本机 :5050 → 宠物轮询状态并用 bot_svg.py 生成情绪动画；完成、待处理和失败事件会分别触发声音提示。app.py 提供 PySide6 无边框透明桌面窗口，server.py 保存当前状态，cli.py 暴露启动、诊断、更新、记忆、人体工学和 GitHub 子命令。记忆系统将各项目的决策、惯例、修复、问题点和用户备注写入 ~/.claude/claude-pet/memory.sqlite，可导入 .ua/knowledge-graph.json，并在 SessionStart 时按权重、时效和 FTS5 匹配生成上下文。重复至少两次的模式可晋升为 SKILL.md，写入 Claude Code 的技能发现路径。GitHub Repo Watcher 使用带 ETag 缓存的轮询读取仓库活动，去重后生成桌面反应和提醒；人体工学模块依据实际活动时间显示带动画、倒计时以及 Done/Skip 操作的休息浮层。

  1. 经常在 Claude Code 执行任务时切换到浏览器、Slack 或其他编辑器的开发者，可通过悬浮表情和声音判断任务正在思考、读写文件、运行命令、等待输入、完成或失败。
  2. 同时维护多个长期项目的个人开发者，可让本地 SQLite 记住各项目的决策、约定、修复和注意事项，并在下一次会话启动时自动提供相关上下文。
  3. 需要关注多个 GitHub 仓库的维护者，可在桌面接收新提交、PR 状态、评审、发布、CI、部署和新议题提醒，而无需部署 webhook 接收端。
  4. 长时间使用终端和编辑器的程序员，可启用活动感知的人体工学计时器，获得眼部休息、收下巴、手腕转动、伸展和饮水提示。
  5. 希望定制开发者桌面吉祥物的贡献者，可基于 PySide6、Flask、SVG 情绪生成器和 PyInstaller 构建脚本添加新表情、练习、仪表板标签或主题。

如何安装或部署这个 Agent？

需要 Python 3.10 或更新版本，以及 macOS 11+、Windows 10+，或带 X11/Wayland 的 Linux。安装过程还会安装 Cairo，并修改 ~/.claude/settings.json 以连接 Claude Code hooks。

macOS 或 Linux 可克隆并运行安装脚本：

git clone https://github.com/nikhilagrima/claude-pet.git ~/claude-pet && cd ~/claude-pet && bash install.sh

README 对 macOS 另行建议使用：

bash install.command

Windows PowerShell：

git clone https://github.com/nikhilagrima/claude-pet.git $HOME\claude-pet
cd $HOME\claude-pet
.\install.bat

安装后可用以下命令进行首次前台启动，以便直接查看日志和宠物窗口：

claude-pet run

监控公开 GitHub 仓库不强制要求凭据。私有仓库或 5000 次/小时的额度需要配置个人访问令牌：

claude-pet github token ghp_yourPAT

如何使用这个 Agent？

在后台启动桌面宠物：

claude-pet start

随后正常使用 Claude Code；安装的 hooks 会把事件送到本机服务。点击宠物打开 HUD，拖动可改变位置，右键可触发表情、立即休息、暂停提醒、切换人体工学功能、重置位置或退出。

检查并修复 hook 路径：

claude-pet doctor

查看当前项目记忆、添加备注并检查下次会话会注入的内容：

claude-pet memory
claude-pet note "Working on the auth refactor, next step is JWT rotation"
claude-pet context

添加并检查 GitHub 仓库监控：

claude-pet github watch facebook/react
claude-pet github list
claude-pet github check
claude-pet github events

查看或即时触发人体工学休息：

claude-pet ergonomics status
claude-pet ergonomics break-now
claude-pet ergonomics stats

更新或停止程序：

claude-pet update
claude-pet stop

这个 Agent 有哪些优点和局限？

优点
  • 把 Claude Code 的思考、读写、命令、完成、失败和待用户处理状态映射为不同动画与声音，切出终端后仍能获知进度。
  • 项目记忆完全保存在本地 SQLite，不使用云端、嵌入模型或向量数据库，并在落盘前使用 11 个敏感信息正则进行脱敏。
  • GitHub 监控不要求公网 webhook；首次轮询静默、事件去重，并以 ETag 缓存降低静默仓库的 API 额度消耗。
  • 人体工学提醒基于 Claude Code 活动而非单纯墙钟计时，空闲三分钟会暂停计时，并可延迟正在输入时触发的提醒。
  • 提供 macOS、Windows 和 Linux 安装器及 PyInstaller 构建脚本，README 还声明有跨三平台的 112 项测试。
局限
  • 核心事件来源和上下文注入都绑定 Claude Code hooks；没有记录 ChatGPT、Codex、Claude.ai 或模型 API 的原生适配路径。
  • 需要常驻本机的 PySide6 窗口和 :5050 Flask 服务，并会写入用户的 Claude 配置、虚拟环境、SQLite 数据库及技能目录。
  • 完整安装依赖 Python 3.10+ 和 Cairo；Linux 还需要 X11 或 Wayland，且二进制不能跨平台编译。
  • GitHub 监控依赖网络轮询；无令牌时限额为每小时 60 次，私有仓库及较高额度需要保存个人访问令牌。
  • 自动上下文注入和从重复模式生成技能会改变后续 Claude Code 会话的输入与技能发现内容，采用前应评估其记忆质量和本地数据策略。
  • 人体工学功能仅是健康提示，不提供诊断或治疗；有疼痛的用户仍需咨询专业人士。

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
Claude Pet 当前 53 · 缺口较多 桌面应用免费 ★ 15 3 个月前 Python Claude Code
projectmem 编程记忆 73 · 存在缺口 命令行工具免费 ★ 878 7 天前 Python Codex · Claude Code · Claude.ai
Citadel 编码代理运行层 84 · 表现良好 Agent 插件 / 技能免费 + 模型费 ★ 927 4 天前 JavaScript Codex · Claude Code
mex 项目记忆 84 · 表现良好 命令行工具免费 ★ 1.8k 4 天前 TypeScript Codex · Claude Code

FollowAgents 如何评估这个 Agent？

FollowAgents 源码审查 · FARS-2.1
缺口较多
53/ 100 五分制 2.7 / 5
信任安全 12/29
可靠稳定 6/14
适用触发 14/18
规范维护 10/18
有效结果 7/13
证据核验 4/8
查看各维度的扣分理由
信任安全12 / 29 · 2.1/5

本地监听地址为 127.0.0.1，写接口有共享令牌保护，记忆数据声明为本地 SQLite，且说明了事件到界面的数据流；这些支持一般用途的权限控制与可见性。扣分原因：安装器会写 Claude Code 设置并启动后台进程，GitHub 轮询可访问网络且 PAT 通过命令行传入；敏感数据正则脱敏仅由 README 声称，未见实现细节；依赖仅设最低版本，没有锁定或安全策略；停止命令在 Windows 会终止所有 python.exe，卸载/恢复仅有简略步骤；来源作者标注为 Byteflow.bot，但身份未验证，更新渠道和维护责任不够清楚。

可靠稳定6 / 14 · 2.1/5

README、pyproject 和代码版本信息不一致：README 标 v0.5.0，pyproject 为 0.7.5；README 声称完成三声提示音，但所示代码设置为单声。依赖和安装条件列得较具体，且有跨平台工作流与测试样例。扣分原因：上述自洽性差异削弱文档可信度；部分异常被静默吞掉，更新失败虽打印信息但没有更完整的恢复指引。

适用触发14 / 18 · 3.9/5

面向 Claude Code 用户与编码场景，列出事件反应、记忆、人体工学提醒、GitHub 监控和多平台支持，场景覆盖充分。扣分原因：能力边界虽提及本地运行、Wayland 限制和非医疗建议，但权限、数据处理和集成触发边界没有完整汇总；触发逻辑的精确配置分散在说明中；不同平台的实际行为有差异，不能由样本充分确认。

规范维护10 / 18 · 2.8/5

README 有安装、CLI、架构、构建、更新、卸载、贡献和限制说明，许可证文件完整。扣分原因：版本与变更记录和包元数据不一致；文件样本无法证明稳定的命名或维护者更新责任；部分安装方式依赖系统包管理器且说明较粗略。

有效结果7 / 13 · 2.7/5

宠物将 Claude Code 状态以动画和声音呈现，记忆注入、休息提醒及 GitHub 活动提示提供了可理解的输出和额外用途。扣分原因：效用主要由 README 宣称，样本没有用户结果证据；常驻置顶窗口、轮询和多项提醒可能带来干扰或维护成本，缺少成本量化及明确的默认取舍。

证据核验4 / 8 · 2.5/5

架构、CLI、依赖、工作流和部分测试能支持若干具体实现描述，README 也列出限制与医疗免责声明。扣分原因：测试样本只覆盖部分路径，不能交叉验证广泛功能与平台承诺；README 中的性能、安全及功能保证多为断言，事实、设计意图和推断未始终区分。

风险与缓解建议
  • 停止命令在 Windows 上可能影响其他 Python 程序；安装和更新前应检查其对设置文件、后台进程及 GitHub PAT 的处理。
  • README 与包元数据的版本不一致，提示音描述也与所示代码不同；应以实际安装版本和配置为准。
  • 记忆与人体工学功能涉及项目活动记录和健康相关提醒；当前样本不足以核实完整的数据保留、脱敏和提醒行为。
证据充分度：低 评估于 2026年11月8日 审查版本 5679bd6573e0
评估证据 README.mdclaude_pet/cli.pyclaude_pet/app.pyclaude_pet/server.pyLICENSEpackage.jsonpyproject.tomlworkflows/build.ymlworkflows/test.ymltests/test_audit_top5.pytests/test_context.py
查看完整评分方法 →
你是这个项目的维护者？把 FARS 徽章加到 README

徽章显示当前的评审分数和结论，点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/claude-pet.svg?lang=zh)](https://followagents.com/zh/agents/claude-pet)
<a href="https://followagents.com/zh/agents/claude-pet"><img src="https://followagents.com/badge/claude-pet.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

  1. v0.7.0
    发布说明摘录
    Full Changelog: https://github.com/nikhilagrima/claude-pet/compare/v0.6.1...v0.7.0
    在 GitHub 查看 ↗
  2. v0.6.1
    发布说明摘录
    Full Changelog: https://github.com/nikhilagrima/claude-pet/compare/v0.6.0...v0.6.1
    在 GitHub 查看 ↗
  3. v0.6.0
    发布说明摘录
    Full Changelog: https://github.com/nikhilagrima/claude-pet/compare/v0.5.11...v0.6.0
    在 GitHub 查看 ↗

常见问题

它会把项目记忆上传到云端吗？
不会。项目记忆位于 ~/.claude/claude-pet/memory.sqlite；README 明确说明它不使用云端、嵌入模型或向量数据库。GitHub 仓库监控本身仍需访问 GitHub 网络接口。
使用 GitHub Repo Watcher 必须提供令牌吗？
公开仓库可以匿名轮询，文档给出的额度是每小时 60 次。私有仓库或每小时 5000 次的额度需要个人访问令牌。
它需要哪些本地权限或文件改动？
安装器会创建 Python 虚拟环境、安装包和 Cairo、修改 ~/.claude/settings.json 中的 hooks，并在 ~/.claude/claude-pet/ 与 ~/.claude/skills/ 下保存配置、记忆或生成的技能。
如果 Claude Code 没有触发正确的动画怎么办？
可运行 claude-pet doctor 诊断并自动修复损坏的 hook 路径；也可用 claude-pet run 在前台运行，以直接查看进程输出。
卸载后会留下后台守护进程吗？
文档给出的卸载流程是依次运行 claude-pet stop、claude-pet uninstall-hooks 和 pip uninstall claude-pet，并声明不会留下 LaunchAgent、计划任务或守护进程。
这页内容对你有帮助吗？
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审，横向比较这个 Agent 所属的短名单。

开源编程 Agent 横向对比

按 FARS 评审排序的开源编程 agent——分数、信任、许可证、语言与维护状态并排比较，并说明各自擅长与不擅长什么。

Claude Code Agent 横向对比

完整兼容 Claude Code 的 agent，按 FARS 评审排序——兼容性取自各 agent 自己的 AGENTS.md 与文档，不做推测。