Codex pets
Start with a finished pet, a hatch-pet brief, or a package check. Each path leads to one focused tool instead of making you decode the whole workflow at once.
PetWidget + SpriteAnimator
Open a pet detail page for the full 9-state preview, or use this compact preview to test interactions quickly.
Start here
Read the explainer that separates official Codex context from the community pet package workflow.
Find a finished petBrowse packages, open a detail page, scan all 9 states, then download or copy the spritesheet URL.
Generate a pet promptUse the Codex pet prompt generator to build a workflow-ready hatch-pet brief before creating a new companion.
Install a packageCheck the folder shape, manifest fields, atlas contract, and local /pet activation steps.
Debug a URLUse the advanced preview only when you already have a browser-accessible spritesheet URL.
Featured packages
A playful pixel unicorn coding companion with a small terminal badge, soft rainbow mane, and friendly idle, waving, waiting, and review animations.
personElvisA tiny Elvis-inspired digital pet with a pompadour, white jumpsuit, and stage-ready charm.
animalTillyA fluffy long-haired calico kitty with a white chest ruff, pink nose, green-yellow eyes, and calm curious expression.
animalMothsealMothseal is an archive moth Codex pet with folded lamina wings, a binder-clip body, red thread details, and amber pinhole eyes.
Core guides
Understand the community package workflow before choosing a pet or building a new hatch-pet brief.
BrowseCompare finished petsOpen example packages, inspect the full state grid, and choose a spritesheet that already matches the Codex pet contract.
InstallAdd a package locallyCheck the manifest, folder shape, spritesheet dimensions, and local activation steps before using a pet in Codex.
BuildOpen the prompt generatorCreate a Codex pet prompt only when you need a new hatch-pet companion instead of installing a finished gallery package.
Practical Codex guides
Install Codex, choose the app or CLI, and build a routine for reviewing and resuming your work.
For a first project, start with one small, checkable task. Before using the result, read the diff and verify a real user action. If work stops midway, preserve the objective, changed files, and next check in a handoff. Each guide includes a worked approach, a bounded prompt, and a way to check the outcome.
FAQ
No. This site helps you browse existing Codex pets, preview spritesheets, copy AI setup prompts, and build AI hatch-pet briefs. Finished new spritesheets still come from the hatch-pet Codex skill plus image generation, or another image workflow.
The easiest way is to open a pet detail page and copy the AI setup prompt. The prompt asks an AI assistant to add and enable that existing pet in Codex, usually by trying the community @eyichan/codexpets CLI first and falling back to the package files if needed.
A Codex pet needs a pet.json manifest and a spritesheet image, usually spritesheet.webp. Both files live inside ~/.codex/pets/<pet-id>/ so Codex can find the custom companion.
The downloadable packages in this catalog use a 1536 x 1872 spritesheet arranged as 8 columns by 9 rows, with 192 x 208 pixel cells. Generation skills and renderers can evolve, so a newly generated pet should follow the contract reported by the installed hatch-pet skill instead of copying an old size blindly.
Open the preview tool and load an example or paste a browser-accessible spritesheet URL. The preview uses codex-pets-react with the shared atlas, so you can switch rows, scale the sprite, and test floating PetWidget behavior.
codex-pets-react is the rendering layer for Codex pet spritesheets in React apps. It provides SpriteAnimator for atlas playback and PetWidget for floating, draggable pet previews.