What problem does it solve?
Creates a Codex-compatible animated desktop pet from a single reference image, removing the manual work of designing and assembling the required sprite atlas and pet manifest.
Core Features & Use Cases
- Builds the Codex Pet artifact: generates pet.json and spritesheet.webp in the exact size and layout Codex expects (1536x1872 atlas, 8x9 cells, 9 animation rows).
- Deterministic animation assembly: makes one canonical pose using RunComfy/OpenAI GPT Image 2 edit and then programmatically derives subtle animation states using ImageMagick micro-transforms.
- Easy local installation: installs the pet into ${CODEX_HOME:-$HOME/.codex}/pets/<name>/ so Codex can load it alongside the built-ins.
Quick Start
Generate a custom Codex Pet atlas and install it by running the codex-pet skill with your source image and pet name and then placing the output files into the local Codex pets directory.