Minty is a mint-haired animated companion for Codex. She runs alongside your tasks, works on a tiny laptop, waits for your input, reviews changes with a magnifying glass, and uses the Codex v2 look-direction rows whenever the app supplies a look target.
An unofficial community pet template. This project is not affiliated with or endorsed by OpenAI.
| Codex state | Preview | What Minty does |
|---|---|---|
idle |
 |
Breathes, blinks, and waits quietly. |
running-right |
 |
Runs to the right. |
running-left |
 |
Runs to the left. |
waving |
 |
Greets you with a wave. |
jumping |
 |
Jumps with excitement. |
failed |
 |
Reacts when a task fails. |
waiting |
 |
Waits for approval or input. |
running |
 |
Works on a tiny laptop while Codex is busy. |
review |
 |
Inspects changes with a magnifying glass. |
| V2 row 9 |  |
Looks up, right, and down-right (000°–157.5°). |
| V2 row 10 |  |
Looks down, left, and up-left (180°–337.5°). |
| V2 full look loop |  |
Cycles clockwise through all 16 look directions. |
Minty's v2 atlas includes 16 clockwise look directions in 22.5-degree steps. Row 9 covers the right half of the circle (000°–157.5°), while row 10 covers the left half (180°–337.5°).
git clone https://github.com/somnusochi/minty-codex-pet.git
cd minty-codex-pet
./install.shRestart Codex after installation, then select Minty — Codex Pet from the pet picker.
Copy both files into the same pet directory:
mkdir -p "${CODEX_HOME:-$HOME/.codex}/pets/minty-codex-pet"
cp pet.json spritesheet.webp "${CODEX_HOME:-$HOME/.codex}/pets/minty-codex-pet/"minty-codex-pet/
├── pet.json
└── spritesheet.webp
The atlas uses the Codex v2 custom-pet contract: 8 columns × 11 rows with 192×208 cells. Rows 0–8 contain the nine standard animations; rows 9–10 contain 16 clockwise look directions. The packaged atlas is 1536×2288, pet.json declares spriteVersionNumber: 2, and the package has passed v2 geometry, transparency, chroma, and direction-semantic validation.
View the complete sprite atlas contact sheet
View the labeled look-direction QA sheet
The machine-readable QA reports are stored in qa/.
Released under the MIT License. You may reuse and adapt the template and artwork while keeping the license notice.