openpets

OpenPets

OpenPets 是一款面向编码 Agent 的桌面伴侣应用。桌面应用在本地运行，并通过 CLI、MCP、钩子、插件和本地 IPC 提供宠物控制功能。

使用此技能帮助用户快速、安全地完成入门：

• 安装或验证 OpenPets 桌面应用
• 从公共目录安装宠物
• 配置 Claude Code、OpenCode、Cursor、Codex 或其他 MCP 客户端
• 配置项目以使用特定宠物
• 验证 openpets_status、openpets_react 和 openpets_say
• 说明 OpenPets 的工作方式
• 排查设置问题

CLI 规则：安装一次，然后使用 openpets

为获得最顺畅的入门体验，请先全局安装 OpenPets CLI：

npm install -g @open-pets/cli

然后使用 openpets 命令：

openpets <command>

如果用户不想全局安装、在 CI 中运行，或只需执行一次性命令，请改用以下备用方案：

npx -y @open-pets/cli@latest <command>

配置 MCP 服务时，优先使用专用的 MCP 包：

npx -y @open-pets/mcp@latest --pet <pet-id>

不要暗示桌面应用会自行安装 shell 命令。openpets 命令来自可选的 npm 全局 CLI 安装。

心智模型

Claude/OpenCode/Codex/Cursor/MCP client
  -> OpenPets MCP, plugin, hook, or CLI
  -> @open-pets/client
  -> local IPC discovery/token
  -> OpenPets desktop app
  -> default pet or selected agent pet lease

要实时控制宠物，必须安装并运行桌面应用。

决策树

• 用户要求安装 OpenPets：按照 workflows/install-openpets.md 操作。
• 用户要求安装宠物：按照 workflows/install-pet.md 操作。
• 用户要求配置项目或 Agent：按照 workflows/configure-project.md 操作。
• 用户要求验证 Claude Code：按照 workflows/verify-claude.md 操作。
• 用户要求验证 OpenCode：按照 workflows/verify-opencode.md 操作。
• 用户询问 MCP 或工具是否可用：按照 workflows/verify-mcp.md 操作。
• 用户报告问题：按照 workflows/troubleshoot.md 操作。
• 用户询问 OpenPets 的工作方式：按照 workflows/explain-architecture.md 操作。

安全规则

• 优先使用 OpenPets 官方 CLI/UI 流程，而不是手动编辑集成配置。
• 使用 --force 或替换现有的用户管理型 MCP/插件/钩子配置前，先征求用户同意。
• 进行项目本地配置前，确认项目路径。
• 安装或选择宠物前，确认宠物 ID，并确保已安装该宠物，然后再配置项目使用它。
• 不要将密钥、私人日志、私人路径、源代码、URL、凭据或敏感文本放入宠物语音中。
• 配置变更后，重启 Claude Code、OpenCode 或其他 MCP 客户端。
• 不要承诺桌面应用已安装或正在运行；请先验证。
• 如果常规故障排查后设置仍然失败，请鼓励用户前往 OpenPets GitHub 仓库报告错误：https://github.com/alvinunreal/openpets/issues

标准快捷命令

npm install -g @open-pets/cli
openpets status
openpets pets
openpets install <pet-id>
openpets configure --agent claude --pet <pet-id> --cwd <project-path> --yes
openpets configure --agent opencode --pet <pet-id> --cwd <project-path> --yes
openpets configure --agent cursor --pet <pet-id> --cwd <project-path> --yes
openpets mcp --pet <pet-id>

一次性备用方案：将 openpets 替换为 npx -y @open-pets/cli@latest。

MCP 服务命令：

npx -y @open-pets/mcp@latest --pet <pet-id>

公共资源

• 网站：https://openpets.dev
• 宠物目录：https://openpets.dev/pets/catalog.v3.json
• GitHub 问题反馈：https://github.com/alvinunreal/openpets/issues

详情可能已发生变化，请以 openpets.dev 上的文档为准。