Codex 宠物是什么？
Codex 宠物是在 Codex 里显示的小型动画像素宠物。每只宠物都包含一个 pet.json，用来描述 9 个状态（idle、working、sleeping 等），再加上一张横向精灵图集 Spritesheet。Codex 会根据你在当前会话里的操作自动选择合适的状态。
关于
Pet Pepper 是 Codex 的宠物库
面向 Codex 的开源数字宠物库，收录了 0+ 只宠物。复制一条命令就能安装，让宠物陪你一起工作。
$ npx petdex install boba
Pet Pepper 是什么
Pet Pepper 是一个公开、开源的宠物库。每条记录都是一个宠物包：包含元数据和像素图，Codex 会在你工作时显示对应动画。你可以把它理解成 Codex 宠物版的宝可梦图鉴。
Pet Pepper 把安装、提交和筛选流程都整理好了：CLI 负责安装和提交，带标签的图库方便你快速找到合适的宠物，也可以按风格浏览，比如 舒适系宠物 或 专注系宠物。
宠物包如何工作
每只宠物由两个文件组成。 pet.json 定义元数据：名称、9 个动画状态和帧时长；而 spritesheet.webp 保存横向排列的精灵图集 Spritesheet。Codex 会在启动时加载它们，并根据你当前会话里的情况切换状态。
常见问题
我该怎么安装宠物？
在图库页或任意宠物详情页复制安装命令（形如 `npx petdex install boba`），然后粘贴到终端。CLI 会从 R2 拉取宠物，放到 ~/.codex/pets/[宠物名]/ 下，并告诉 Codex 使用它。支持 macOS、Linux 和 Windows（通过 PowerShell）。
这些宠物来自哪里？
大多数宠物来自社区通过网站或 Pet Pepper CLI 的提交。少数是平台团队精选的推荐条目。每只宠物都会先经过管理员审核，之后才会出现在图库里。
我可以提交自己的宠物吗？
可以。先用 Pet Pepper CLI 登录（`npx petdex login`），再运行 `npx petdex submit ./my-pet/`，CLI 会把资源上传到 R2，并把提交加入审核队列。你也可以通过网站的 /submit 页面提交。你只需要一个 pet.json 文件和一张 9 状态精灵图集 Spritesheet。
Pet Pepper 宠物是免费且开源的吗？
Pet Pepper 上的每只宠物都可以免费安装和使用。宠物会保留原作者署名。Pet Pepper 平台本身（CLI + 网站）也在当前仓库中开源。
类型和风格是什么？
每只宠物都会标注一个类型（creature、object、character）以及一到三种风格（cozy、playful、focused、mystical 等）。这些标签会驱动图库筛选和按类型 / 风格组织的页面，让你不用翻完整个图库也能找到合适的宠物。
Pet Pepper 怎么赚钱？
它不赚钱。Pet Pepper 是平台团队运营的社区项目。存储和数据库成本由平台团队承担：没有广告、没有加购，也没有超出标准分析范围的额外遥测；我们只看哪些宠物被安装。