Optional OpenAI Codex-compatible v2 animated desktop pet featuring a Liu Yuning-inspired chibi character. This is a standalone mascot and sprite package for macOS AI coding workflows—not a token monitor and not a required dependency of Codex Token Bar.
If you are looking for a Codex desktop pet, OpenAI Codex animated companion, macOS developer mascot, Codex spritesheet, chibi assistant, or an installable v2 pet asset, this repository is the optional character package you can download separately.
LYN Codex Pet 是一个可选的、独立的 Codex 兼容桌面宠物资源包，提供刘宇宁风格的 Q 版 / chibi 宠物形象。它适合 macOS AI 编程、开发者桌面助手和 Codex 桌面宠物场景，包含完整的动画精灵图、宠物清单、动作预览和视线方向预览。
这个仓库与 Codex Token Bar 完全分开。Token Bar 是查看 Token 用量和额度的菜单栏工具；LYN Codex Pet 只是可选的视觉形象。喜欢 Token Bar 但不想使用刘宇宁 Q 版形象的用户，不需要下载本仓库。
宠物包采用 Codex v2 格式：8×11 RGBA 精灵图、9 个标准动画状态和 16 个视线方向，并附带结构与透明度校验报告。它不读取 Token、不联网、不需要 API Key，也不是官方 OpenAI 或刘宇宁产品。
| Item | Details |
|---|---|
| Pet | LYN — Liu Yuning-inspired Q-version / chibi character |
| Format | Codex-compatible v2 RGBA sprite atlas |
| Layout | 8 columns × 11 rows, 1,536 × 2,288 px |
| Animation | 9 standard states plus 16 look directions |
| Runtime | Local-first; no API key and no network service |
| Relationship to Token Bar | Fully optional and independent |
- 提供可安装的 Codex v2 动画宠物精灵图。
- 支持待机、工作、等待、审核、失败、挥手、跳跃等标准动作。
- 支持 16 个连续视线方向，适合桌面宠物的注意力与交互表现。
- 提供标准动作联系表、视线方向图和透明度验证结果。
- 宠物资源与 Token Bar 解耦，两个项目可以分别安装、分别使用。
assets/lyn/spritesheet.webp— the ready-to-install 8×11 Codex v2 sprite atlas.assets/lyn/pet.json— the pet manifest with ID, display name, description, andspriteVersionNumber: 2.assets/lyn/contact-sheet.png— standard animation preview.assets/lyn/look-directions.png— directional gaze preview.assets/lyn/validation.json— deterministic structural and transparency validation report.
The published asset passed validation with ok: true, including the required atlas dimensions, RGBA mode, transparent background, and v2 metadata.
Copy the manifest and sprite atlas into the Codex pet directory:
mkdir -p ~/.codex/pets/lyn
cp assets/lyn/pet.json ~/.codex/pets/lyn/
cp assets/lyn/spritesheet.webp ~/.codex/pets/lyn/Restart or reload the Codex pet host after copying. If you only want quota monitoring, install Codex Token Bar without this repository.
将 pet.json 和 spritesheet.webp 复制到 ~/.codex/pets/lyn/ 后，重启或重新加载 Codex 宠物宿主即可。只需要 Token 额度监控时，请单独安装 Token Bar，不必安装本宠物包。
This is an optional animated mascot asset for Codex-compatible desktop pet hosts. It does not contain the Token Bar application, token accounting logic, rate-limit reader, or local session-log parser. Token Bar can run by itself, and users who do not want the LYN character do not need to download this repository.
The asset is designed for local macOS developer workflows and AI coding assistants. It is not an official OpenAI or Liu Yuning product, endorsement, or affiliation.
It is a standalone animated desktop pet package: a Q-version / chibi character, Codex v2 sprite atlas, manifest, previews, and validation metadata.
No. Codex Token Bar is a separate macOS menu bar token-usage and rate-limit monitor. LYN Codex Pet is an optional visual companion.
No. It only provides the pet artwork and package metadata. For token usage, context-window pressure, cached tokens, and reset times, use Codex Token Bar separately.
It uses the v2 pet.json manifest and an 8×11 RGBA atlas with standard animation rows and 16 look-direction cells. The included validation.json records the passing checks.
This project is relevant to searches for: OpenAI Codex pet, Codex desktop pet, Codex animated mascot, Codex companion, macOS desktop pet, AI coding assistant mascot, Codex spritesheet, animated sprite atlas, chibi developer mascot, Liu Yuning chibi pet, 刘宇宁 Q版宠物, Codex v2 pet, and optional Codex character asset.
openai-codex codex codex-pet desktop-pet animated-pet macos spritesheet sprite-atlas animated-mascot ai-coding developer-tools local-first chibi liu-yuning
This is a fan-made character asset for personal and experimental use. It is not an official Liu Yuning product, endorsement, or affiliation.