CODEX PETS · OPEN-SOURCE PIXEL PETS
Guide
Hatch your own pet online, or pick one from the gallery, and bring it into Codex.
01
Get a pet
Hatch your own from text or an image on the Hatch page, or pick a ready-made one in the Gallery.
02
Download files
Grab spritesheet.webp and pet.json from the result/detail page (online hatch also gives a one-line install command).
03
Install
Put both files in ~/.codex/pets/<name>/, or just paste the provided command to do it in one go.
04
Enable
Restart Codex, then pick your pet under Settings → Appearance → Pets.
✓ Check it worked
- Run the install command (or place the files manually).
- Fully quit and restart Codex.
- Open Settings → Appearance → Pets.
- Select your pet from the list.
- Type /pet in a chat — your pet should appear and animate.
Not showing up? Check these
- Confirm the path is ~/.codex/pets/<name>/ and the folder has both spritesheet.webp and pet.json.
- File names must be exactly spritesheet.webp and pet.json (no extra suffix, no capitals).
- If you used npx, make sure Node.js is installed (node -v prints a version).
- Still nothing after restarting Codex? Update to the latest Codex and try again.
- Still stuck? Email [email protected] with your OS and any error.