Codex Pet Generator
Create a custom Codex digital pet from a prompt or reference image, preview the required animation states, and package the files Codex expects: pet.json and spritesheet.webp.
Optional image reference
Use a logo, mascot, sketch, or screenshot as visual direction when you want a tighter identity.
Loading models...
Installable package
Generate the package, then copy one short command that downloads the ZIP and installs it into your Codex pets folder. Codex will not switch pets automatically after the command runs.
Generate all states to unlock downloads and a short copy-paste installer.After running the command
- 1Open Codex Settings > Appearance > Pets or Avatar.
- 2Click Refresh Custom Pets.
- 3Select the new custom pet by name.
- 4Make sure the Codex Avatar is shown; if the avatar overlay is hidden, show it again from Appearance.
- 5If the old pet is still visible, restart Codex, then refresh and select the pet again.
State preview
Preview every Codex pet state before install
Codex pets use a fixed 8x9 spritesheet atlas. Switch states to check frame counts, animation intent, and whether the generated pet keeps the same identity across the full sheet.
Row 0 / 6 frames
Idle
neutral idle loop with subtle breathing and blinking, steady centered pose
AI workflow
From prompt to Codex-ready pet files
The page is built around the real Codex custom pet contract instead of a generic image generator flow.
Describe the pet
Start with a compact mascot brief: shape, colors, face, props, personality, and any reference image you want to preserve.
Generate the atlas
The generator targets a 1536x1872 spritesheet.webp with 8 columns, 9 rows, transparent cells, and state-specific frame counts.
Preview states
Review idle, running, waving, jumping, failed, waiting, and review loops before you move the package into Codex.
Install locally
Copy the generated short install command into your terminal, refresh and select the Custom Pet in Settings > Appearance > Pets, then make sure the Codex Avatar is shown.
File contract
What the codex pet generator creates
A valid custom pet is a small local package. The folder name under $HOME/.codex/pets becomes the custom pet entry Codex can load.
pet.json manifest
Defines id, displayName, description, and spritesheetPath. The spritesheetPath normally points to spritesheet.webp.
spritesheet.webp atlas
A transparent 1536x1872 WebP or PNG atlas arranged as 8 columns x 9 rows with 192x208 cells.
Nine animation rows
Rows are idle, running-right, running-left, waving, jumping, failed, waiting, running, and review.
Local Codex install
Install by placing both files under $HOME/.codex/pets/<pet-name>/, refreshing Custom Pets, selecting the new pet, and showing the Codex Avatar.
{
"id": "pixel-sprout",
"displayName": "Pixel Sprout",
"description": "A compact Codex digital pet generated from your brief.",
"spritesheetPath": "spritesheet.webp"
}1536x1872 WebP atlas, 8 columns x 9 rows, 192x208 cell, transparent unused slots.
Copy-paste install
Install your generated pet in Codex
After generation, the copied command downloads the generated ZIP package and unpacks it where Codex expects it. On Windows, use the same folder under your user profile's .codex directory.
Generate files
Create the complete pet.json manifest and spritesheet.webp atlas from the generator output.
Paste install command
Run the copied Windows or macOS/Linux command to download the ZIP, create $HOME/.codex/pets/<pet-name>/, and unpack both files.
Refresh Custom Pets
Open Settings > Appearance > Pets in Codex and click Refresh Custom Pets so Codex scans the installed folder.
Select the new pet
Choose the generated custom pet by name. The install command only copies files; it does not automatically replace the current pet.
Show the Avatar
After selecting the pet, make sure the Codex Avatar overlay is visible. Some older instructions mention /pet, but current Codex builds usually control visibility from Appearance's Avatar/Pets settings.
FAQ
Codex Pet Generator FAQ
What is a Codex pet?
A Codex pet is a small animated digital companion shown by the Codex app. Custom pets are loaded from local folders under the Codex home pets directory.
What files do I need to install a Codex pet?
You need pet.json and spritesheet.webp in the same pet folder. The manifest points Codex to the spritesheet file.
Which animation states should a codex pet generator preview?
A practical generator should preview idle, running-right, running-left, waving, jumping, failed, waiting, running, and review.
Can I paste one command to install the pet?
Yes. After generation, the copied command downloads the generated ZIP package, creates the target Codex pets folder, and unpacks both files there. After it finishes, refresh Custom Pets, select the new pet in Codex Settings, and make sure the Codex Avatar is shown.
Do I need to sign in?
Yes. This page uses your configured image-generation credit flow so every generated base image or state row is tracked and charged consistently.
Why do transparent backgrounds matter?
Codex pets sit on top of the app UI, so unused cells and row backgrounds must be transparent. Models with transparent support are preferred; other models use a chroma-key prompt and browser cleanup.