codex-pet
Generate Codex-compatible custom desktop pets from a single image via RunComfy.
- Produces a 1536x1872 PNG/WebP spritesheet with 9 animation rows (idle, running, waving, jumping, failed, waiting, running, review) and
pet.jsonmanifest ready to drop into${CODEX_HOME:-$HOME/.codex}/pets/<name>/ - Calls OpenAI GPT Image 2 edit once to generate a canonical chibi-proportioned pose, then assembles all animation frames programmatically with ImageMagick micro-transforms (1–2 px shifts, blinks, tilts)
- Requires only
RUNCOMFY_TOKEN, RunComfy CLI, and ImageMagick — no Codex Pro, no$imagegen, noOPENAI_API_KEY - Triggers on "codex pet", "create codex pet", "hatch", "spritesheet.webp", or explicit requests to build custom Codex Pets
Codex Pet — Pro Pack on RunComfy
runcomfy.com · GPT Image 2 edit endpoint · docs
Codex Pet generator on RunComfy. Turn one source image into a Codex-compatible custom Codex Pet — pet.json + spritesheet.webp — drop it into ${CODEX_HOME:-$HOME/.codex}/pets/<name>/, Codex picks it up next to the 8 built-in Codex Pets.
npx skills add agentspace-so/runcomfy-agent-skills --skill codex-pet -g
What a Codex Pet is
OpenAI Codex Pets (released May 2026) are pixel-art animated companions that float over your desktop while Codex codes — they react to mouse interaction and Codex status (scratching head when thinking, popping a speech bubble when a task completes). Codex ships with 8 built-in Codex Pets and supports custom Codex Pets installed locally as a folder under ${CODEX_HOME:-$HOME/.codex}/pets/.
Each custom Codex Pet folder contains exactly two files:
pet.json— manifest withid,displayName,description,spritesheetPath.spritesheet.webp— Codex Pet sprite atlas, 1536x1872 PNG or WebP, 8 columns x 9 rows of 192x208 cells, transparent background.