Codex Pet - Pro Pack on RunComfy

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.json manifest 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, no OPENAI_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 with id, displayName, description, spritesheetPath.

- spritesheet.webp - Codex Pet sprite atlas, 1536x1872 PNG or WebP, 8 columns x 9 rows of 192x208 cells, transparent background.