Codex Pets is a public gallery for Codex-compatible animated pets. Each approved entry has a detail page, previewable animation states, a downloadable ZIP, and links to its source pet.json and spritesheet assets.
How a pet pack works
A pack is intentionally small: pet.json describes the pet metadata and animation settings, while spritesheet.webp or spritesheet.png contains the visual atlas. The current atlas is 8 columns by 9 rows at 1536x1872.
Install or submit
Approved pets can be installed from npm with the Codex Pets CLI. Creators can submit packs from the submit page; admins review every submission before it appears in the gallery, sitemap, and public manifest.
FAQ
What is a Codex pet?
A Codex pet is a small animated companion that Codex can display while you work. Each public listing in this gallery is a downloadable pet pack with metadata and pixel art.
How do I install one?
Use the npm CLI command from the gallery or a pet detail page. The CLI reads the public manifest, downloads the pet files, and writes them into your Codex pets directory.
Can I submit my own pet?
Yes. Upload a ZIP, or upload pet.json plus spritesheet.webp or spritesheet.png from the submit page. New submissions stay pending until an admin reviews them.
What files does a pack need?
A pack needs pet.json and one spritesheet file at the root. The current validator expects an 8x9 atlas at 1536x1872, with each cell sized for Codex pet animation states.