AI 仓库情报摘要

FR-AI / ANALYSIS

为什么值得关注

它展示了如何为 OpenAI 的 Codex 应用安装自定义宠物，为编程环境增添趣味和个性化，而官方应用虽支持此功能但尚未提供现成宠物。

适合谁使用

希望编程体验更愉悦的 Codex 应用用户
想了解或创建 Codex 自定义宠物的开发者
喜欢桌面宠物和个性化工具的爱好者
乐于深度定制开发环境的进阶用户

典型使用场景

安装奈蛙，让日常编码过程更轻松愉快
以此仓库为模板，设计并贡献新的宠物
通过安装步骤学习 Codex 自定义宠物系统
使用现成宠物测试 Codex 的「自定义宠物」功能是否正常

项目优势

提供了 macOS、Linux 和 Windows 清晰的安装指南
宠物文件夹结构简单（仅 pet.json 和 spritesheet.webp），易于理解
首个宠物（奈蛙）有详细的视觉描述，表明设计用心
仓库明确警告不要嵌套文件夹，避免用户安装错误

使用前须知

目前只有一只宠物，种类不够丰富
尚未添加许可证，所有权利保留，复用存在不确定性
安装需手动复制文件夹，并非一键安装或应用内直接安装

README 快速开始

Awesome Pets for Codex App

English · 简体中文

A growing collection of friendly companions for the Codex App.

About

Awesome Pets is a collection of custom pets for the Codex App. These companions are here to make coding, research, and everyday tasks feel a little more cheerful.

First to Arrive: Nai Frog

The first update introduces Nai Frog: a cheerful, round yellow companion with a cream-colored belly, bright green eyes, and a signature belly-holding laugh.

naifrog/
├── pet.json
└── spritesheet.webp

pet.json: pet metadata and spritesheet configuration
spritesheet.webp: the animated spritesheet for Nai Frog

Install in the Codex App

Option 1: Use the pet folder in Settings (recommended)

Download or clone this repository:

git clone https://github.com/Nitrogen216/awesome_pets.git

Open the Codex App and go to Settings → Pets → Custom pets.
Select Open folder to open the local custom-pet directory.
Copy the repository's naifrog folder into that directory.
Return to the Codex App and select Refresh.
Select Nai Frog. If pets are currently hidden, select Wake Pet.

The final layout must be:

/pets/
└── naifrog/
    ├── pet.json
    └── spritesheet.webp

Do not copy the entire awesome_pets repository as a nested folder under pets; the Codex App looks for pet.json directly inside each pet directory.

Option 2: Install from a terminal

macOS or Linux

git clone https://github.com/Nitrogen216/awesome_pets.git
mkdir -p "${CODEX_HOME:-$HOME/.codex}/pets/naifrog"
cp -R awesome_pets/naifrog/. "${CODEX_HOME:-$HOME/.codex}/pets/naifrog/"

Windows PowerShell

git clone https://github.com/Nitrogen216/awesome_pets.git
$codexHome = if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $HOME ".codex" }
$petDir = Join-Path $codexHome "pets\naifrog"
New-Item -ItemType Directory -Force $petDir | Out-Null
Copy-Item ".\awesome_pets\naifrog\*" $petDir -Recurse -Force

After copying the files, open Settings → Pets and select Refresh, then choose Nai Frog. Restart the Codex App if the pet does not appear after refreshing.

By default, Codex home is ~/.codex on macOS and Linux and $HOME\.codex on Windows. If CODEX_HOME is set

项目描述