alvinunreal/openpets

Desktop pets for AI coding agents. Install pets, connect Claude Code via MCP, and see live coding status on your desktop.

ai-agentsbunclaude-codecoding-agentsdesktop-petelectronmcpopencodeopenpetspixel-art

GAI 中文摘要

OpenPets 是一个基于 Electron 开发的桌面宠物应用，旨在为开发者的工作环境增添趣味与陪伴。它通过集成 AI 编程代理（如 Claude Code），将实时的编码活动反馈为桌面宠物的动态行为，从而实现开发效率与交互体验的有机结合。

该项目提供了一个始终活跃的桌面宠物，能够进行闲置动画、互动反馈以及各种拟人化行为。它内置了番茄钟、强制休息提醒和专注模式等实用功能，即使不连接编程工具也能提供日常陪伴。通过支持 MCP 协议，它可以与任何兼容的 AI 代理连接，实时接收指令并展示编码状态。用户还可以安装多种动画宠物包，实现高度的个性化定制。

该项目特别适合长时间独自面对屏幕的开发者，能够显著缓解高强度编程带来的枯燥感。它不仅可以作为桌面装饰，也适用于需要自动化提醒休息或希望将 AI 代理的工作进度可视化呈现的各类技术工作流场景。

⭐

986

Stars

🔱

Forks

👁

Watchers

📋

Issues

TypeScriptMIT创建于 2026/5/4更新于今天

在 GitHub 上查看访问主页

README

由 Gemini 翻译整理

OpenPets

一个能陪伴你的微型桌面宠物。

一个生活在你的桌面上的俏皮宠物，陪伴你左右，并能通过内置功能和开发者集成不断成长。

由 Boring Dystopia Development 开发

2 分钟快速入门

从 OpenPets Releases 下载并启动桌面应用程序。桌面宠物会立即出现；得益于内置功能，无需配置任何 Agent，它看起来就充满活力。

如果你还想集成 AI 编码 Agent，请使用 skills.sh 安装 OpenPets Agent Skill：

npx skills add alvinunreal/openpets --skill openpets

然后打开 Claude Code、OpenCode、Codex 或其他支持技能的 Agent 并输入：

Use the OpenPets skill. Install OpenPets for me, connect this agent, and verify the integration works.

对于项目设置，请在仓库中打开你的 Agent 并输入：

Use the OpenPets skill. Help me choose or install a pet, configure it for this project, and verify the project integration.

实用的提示词：

Use the OpenPets skill. Configure this project for Claude Code with a pet.
Use the OpenPets skill. Configure this project for OpenCode with a pet.
Use the OpenPets skill. Debug why openpets_status is unavailable.

为 OpenPets 点赞 (Star)

这是一个我为自己的仓库点赞的 GIF，以此鼓励你也这样做。如果 OpenPets 让你的编程体验变得更有趣，请给这个项目点个 Star。

什么是 OpenPets？

OpenPets 是一款以系统托盘为主的桌面陪伴应用。宠物会出现在你的桌面上，陪伴你，并能使用内置功能进行环境互动、休息提醒、俏皮动作和专注时段管理。作为进阶开发者层，它还支持编码 Agent 集成。

桌面陪伴 - 一只会在配置开发者工具之前就进行待机、互动并带来友好氛围的小宠物。
内置功能 - 原生插件可以添加环境签到、休息提醒、宠物俏皮动作、专注计时器、小憩散步以及可选的开发者通知。
开发者集成 - 针对 Claude Code、OpenCode、Cursor、Pi 和支持 MCP 的工具提供进阶设置，让编码活动驱动宠物行为。
支持 MCP - 任何支持 MCP 的 Agent 都可以通过 OpenPets MCP 服务器发送简短、安全的对话气泡和反应。
支持宠物包 - 加载已安装的动画宠物包，并能为选定的 Agent/项目分配专属的宠物窗口。
注重隐私 - 自动触发的对话气泡内容是静态且本地化的；提示词、代码、日志、命令输出、URL、路径和密钥等敏感信息绝不会显示在气泡中。

管理你的宠物

你可以通过 OpenPets 桌面应用程序浏览已安装的宠物、预览动画，并选择每个编码 Agent 要跟随的伙伴。

快速开始

安装桌面应用程序，然后根据需要连接你的编码 Agent。

1. 安装 OpenPets 桌面版

从 OpenPets Releases 下载最新版本：

macOS Apple Silicon: OpenPets-*-mac-arm64.dmg
macOS Intel: OpenPets-*-mac-x64.dmg
Windows: OpenPets-*-win-x64-setup.exe
Linux: OpenPets-*-linux-x86_64.AppImage

启动 OpenPets。你应该能看到桌面宠物和 OpenPets 托盘/菜单栏图标。

当前版本可能未经过签名。在首次打开应用程序时，macOS 或 Windows 可能会显示安全警告。

如果 macOS 提示应用已损坏或应移至废纸篓，请移除隔离标志并重新打开：

xattr -dr com.apple.quarantine /Applications/OpenPets.app
open /Applications/OpenPets.app

2. 可选：连接你的 Agent

在可用时，使用桌面端的 Integrations 界面进行全局设置：

Claude Code - 安装 OpenPets MCP、Claude 记忆指令以及可选的 Claude 钩子（hooks）。
OpenCode - 安装 OpenPets MCP、OpenCode 指令文件以及 @open-pets/opencode 插件。

对于项目本地设置，请在你想要配置的项目中运行 CLI：

npx -y @open-pets/cli@latest configure --agent claude --pet 
npx -y @open-pets/cli@latest configure --agent opencode --pet

如果你更喜欢永久的 openpets shell 命令，可以使用 npm install -g @open-pets/cli 全局安装 CLI，然后将 npx -y @open-pets/cli@latest 替换为 openpets。

项目本地设置可能会创建 .claude/settings.local.json 或 .opencode/opencode.jsonc 等项目文件。提交前请检查它们，因为其中可能包含选定宠物的 ID。

进阶：Agent 集成

OpenPets 的集成包含三个层级：

MCP tools：用于显式的 Agent 操作。
Agent instructions：让 Agent 知道何时使用这些工具。
Hooks/plugins：用于在正常 Agent 工作期间进行自动化的装饰性反馈。

Claude Code

Claude Code 集成支持：

通过 Claude Code 进行 openpets MCP 设置。
管理 Claude 记忆。