Submit

Add your pet to codex-pet

Share a Codex-compatible animated pet package. We check the files locally, preview the sprite, and submit it for review.

Prefer the terminal?

Submit pets without leaving your shell. After signing in once, point the CLI at a folder (or a parent directory of folders) to submit them in bulk.

npx codex-pet-cli login
npx codex-pet-cli submit ~/.codex/pets/fox
# or submit every pet under a directory:
npx codex-pet-cli submit ~/.codex/pets

Folders must contain pet.json and spritesheet.{webp,png} (≥ 256×256). See the CLI docs for the full command list.

By submitting, you confirm you have rights to the artwork or are creating fan content. Pending submissions appear after a maintainer approves them.