Question 1

What is a Codex Pet?

Accepted Answer

A Codex Pet is a local custom pet package for Codex Desktop. A valid package contains pet.json and spritesheet.webp and is installed under ~/.codex/pets/<pet-name>/.

Question 2

What spritesheet size does a Codex Pet use?

Accepted Answer

The current Codex Pet atlas is 1536x1872 pixels, organized as an 8 column by 9 row grid with 192x208 pixel cells.

Question 3

How do I install hatch-pet?

Accepted Answer

Run $skill-installer hatch-pet in Codex, restart Codex, then start a fresh conversation and run $hatch-pet with a pet concept or reference image.

Package folder	`~/.codex/pets/<pet-name>/`
Required manifest	`pet.json`
Required spritesheet	`spritesheet.webp`
Atlas size	`1536x1872`
Grid	`8 columns x 9 rows`
Cell size	`192x208`
Format	`transparent WebP / RGBA`

Codex Pet

Quick Facts

Codie Pack (Sample)

Idle

Run Right

Run Left

Wave

Jump

Failed

Download Codie

Codie

Guides & Resources

Developer Docs