openpets

桌面养只宠物，编码状态一眼看穿

开源 🏷️定价信息待确认 ✅ 目前可打开智能体 🍴 复刻 1

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 4

维护状态维护中

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类智能体

开发团队alvinunreal

官网地址https://openpets.dev

GitHubhttps://github.com/alvinunreal/openpets

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态✅ 目前可打开

是否开源是

GitHub 星标★ 4

上线时间2026-09-27 00:00:00

代码更新2026-09-27

本站数据更新2026-11-08

维护状态维护中

收录时间2026-08-09

浏览次数4

项目介绍

OpenPets 是一个本地优先的桌面宠物伴侣平台，通过 Electron 构建，将动画宠物带入桌面，同时为开发者提供插件 SDK 和编码智能体集成能力。它解决了开发者在长时间编码时缺乏陪伴感、工作状态可视化不足的问题，核心能力包括：支持 Claude Code、OpenCode 等编码智能体的状态接入，让宠物实时反映编码进度、构建状态或错误提醒；提供插件系统，允许用户自定义宠物行为、动画和交互；本地优先设计，数据不出本机，保护隐私。项目用 TypeScript 编写，面向开发者社区，既可作为趣味桌面装饰，也能作为生产力工具的状态指示器，将原本枯燥的开发过程变得生动有趣。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 4

使用教程

难度：入门约 10 分钟部署方式：本地安装 6 步

环境要求

macOS / Windows / Linux 桌面系统（Windows 发布安装包已签名，macOS 可能未签名）
需要 Node.js 环境，用于运行 npx 形式的 CLI 与 MCP 服务
可选：支持 MCP 的编码智能体（如 Claude Code、Cursor）
可选：pnpm，仅在从源码构建打包桌面端时需要

安装与启动步骤

1下载对应安装包

打开 GitHub Releases 页面，按系统选择安装包：macOS 选 dmg（Apple Silicon 用 arm64、Intel 用 x64），Windows 用 setup.exe，Linux 用 AppImage。
2安装并启动应用

按各系统常规方式安装后启动 OpenPets。安装包通过官方 Releases 分发，无需连接任何 AI 智能体即可开箱使用。
3macOS 解除隔离

若 macOS 因未签名阻止运行，在终端执行命令移除隔离标记后重新打开应用；Windows 安装包已签名一般无此问题。
```
xattr -dr com.apple.quarantine /Applications/OpenPets.app
```
4诊断本地集成

检查 Claude hook、项目 Cursor MCP 集成是否已安装、需更新或已损坏，以及桌面应用是否可达。仅当集成损坏时返回非零退出码。
```
npx @open-pets/cli doctor
```
5配置 MCP 服务

把 OpenPets 作为 MCP 工具接入智能体：在智能体配置文件中加入 mcpServers 配置块，通过 npx 拉起 @open-pets/mcp。
```
{
  "mcpServers": {
    "openpets": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@open-pets/mcp@latest"]
    }
  }
}
```
6源码构建打包

如需自行构建安装包，在已安装依赖的项目目录执行打包命令，生成最终的安装器与分发包。
```
pnpm package:desktop
```

关键配置

配置项	必填	说明	示例
`mcpServers.openpets.type`	是	MCP 服务连接类型，README 中固定为 stdio	`stdio`
`mcpServers.openpets.command`	是	启动 MCP 服务的可执行命令	`npx`
`mcpServers.openpets.args`	是	传给 npx 的参数，指定 MCP 包与最新版本	`["-y", "@open-pets/mcp@latest"]`
`--pet <petId>`	否	让 MCP 服务指向特定的宠物 ID	`--pet <petId>`
`--cwd <path>`	否	doctor 命令用于检查其他项目的 .cursor/mcp.json	`--cwd /your/path`
`--json`	否	doctor 命令输出机器可读的 JSON 结果	`--json`