CPCodex Pets

Codex pets

Browse, build, and install Codex pets faster.

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.

Browse Codex pets Build hatch-pet prompt
1536 x 1872 atlas8 x 9 grid192 x 208 cells

PetWidget + SpriteAnimator

Live Codex pet preview

Open a pet detail page for the full 9-state preview, or use this compact preview to test interactions quickly.

Floating mode uses viewport bounds.

Start here

Pick the job you actually need.

Understand Codex pets

Read the explainer that separates official Codex context from the community pet package workflow.

Find a finished pet

Browse packages, open a detail page, scan all 9 states, then download or copy the spritesheet URL.

Create a new pet

Build a workflow-ready hatch-pet brief that asks Codex to check the skill before generation.

Install a package

Check the folder shape, manifest fields, atlas contract, and local /pet activation steps.

Debug a URL

Use the advanced preview only when you already have a browser-accessible spritesheet URL.

Featured packages

Open a pet page when you want the full state grid.

View gallery
animalPixelcorn

A playful pixel unicorn coding companion with a small terminal badge, soft rainbow mane, and friendly idle, waving, waiting, and review animations.

personElvis

A tiny Elvis-inspired digital pet with a pompadour, white jumpsuit, and stage-ready charm.

animalTilly

A fluffy long-haired calico kitty with a white chest ruff, pink nose, green-yellow eyes, and calm curious expression.

Core guides

Move from definition to package to local install.

ExplainerWhat are Codex pets?

Understand the community package workflow before choosing a pet or building a new hatch-pet brief.

BrowseCompare finished pets

Open example packages, inspect the full state grid, and choose a spritesheet that already matches the Codex pet contract.

InstallAdd a package locally

Check the manifest, folder shape, spritesheet dimensions, and local activation steps before using a pet in Codex.

BuildWrite a hatch-pet prompt

Create a generation brief only when you want a new pet instead of installing one of the finished packages from the gallery.

FAQ

Codex pet basics

Can this site generate a finished Codex pet spritesheet?

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.

What is the easiest way to use a pet from this site?

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.

What files does a Codex pet need?

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.

What spritesheet layout does Codex use?

Codex pets use a 1536 x 1872 spritesheet arranged as 8 columns by 9 rows. Each frame cell is 192 x 208 pixels, and each row maps to a shared animation such as idle, waving, waiting, failed, or review.

How do I preview a Codex pet before installing it?

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.

What is codex-pets-react used for?

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.