crafter-station/petdex

这是什么？

核心功能

• 01通过 `npx petdex install <slug>` 浏览并安装动画宠物。
• 02可通过命令行或网页提交自己的宠物。
• 03桌面悬浮窗会在编程代理每次调用工具时让宠物播放动画。
• 04公开的 manifest 接口列出所有已审核宠物及其精灵图地址。
• 05支持个人合集，可通过命令行列出、创建、编辑和删除。

适用场景

• 为 Codex 或 Claude Code 会话添加一个会随代理活动变化的视觉伙伴。
• 分享或下载像素风吉祥物，用于个人桌面设置。
• 基于公开 API 开发读取宠物数据的自定义桌面客户端或小组件。
• 制作并发布自己的动画精灵宠物供社区使用。

快速上手

1. 1

   使用 CLI 安装一个已知宠物

   npx petdex install boba
2. 2

   从 petdex.dev/download 下载桌面应用

3. 3

   打开应用，在宠物上按 Cmd+,，在 Pets 中选择宠物，在 Agents 中连接代理

使用前须知

• !桌面应用和宠物主要面向 Codex 及受支持的编码代理。
• !宠物美术由用户提交，版权归提交者所有，而非项目方。

标签

常见问题

petdex 是什么？

一个公开的动画宠物画廊与命令行工具，可浏览、安装和提交像素风宠物，并随 Codex 等编程代理的活动做出反应。 Petdex 是一个社区动画宠物画廊，宠物用于陪伴 Codex，也支持 Claude Code、Gemini CLI、OpenCode 等编程代理。每个宠物由一个 pet.json 元数据文件和一张动画帧精灵图组成。用户可以在 petdex.dev 浏览宠物，用一条 npx petdex install 命令安装，也可以提交自己的作品。

petdex 可以免费使用吗？用的什么许可证？

petdex 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

petdex 还在维护吗？

活跃维护中。petdex 最近一次提交是在 2026年10月10日。

petdex 适合用来做什么？

为 Codex 或 Claude Code 会话添加一个会随代理活动变化的视觉伙伴。 分享或下载像素风吉祥物，用于个人桌面设置。 基于公开 API 开发读取宠物数据的自定义桌面客户端或小组件。 制作并发布自己的动画精灵宠物供社区使用。

petdex 怎么安装和运行？

使用 CLI 安装一个已知宠物: npx petdex install boba 从 petdex.dev/download 下载桌面应用 打开应用，在宠物上按 Cmd+,，在 Pets 中选择宠物，在 Agents 中连接代理

在哪里获取 petdex？

源代码和安装说明在 GitHub 上：https://github.com/crafter-station/petdex