Skip to content

Pet download and install

Download and install Codex pets

Choose a reviewed pet, install it with one npx command or ZIP, and inspect the package before activating it.

Fastest install

Start with Node.js 20 or newer. Browsing and installing public pets does not require an account.

Copy CLI command: npx codexpetdb install 'gi-yoimiya'

The complete path from download to activation

  1. 01

    Choose a reviewed pet

    Open a public pet from the gallery or the list below to preview its animation, package version, and actual files.

  2. 02

    Use the CLI or download a ZIP

    Install with PetDB CLI, or download the ZIP from a pet detail page. The package root contains only pet.json and one spritesheet; the default folder is ~/.codex/pets/<pet-slug>, or %USERPROFILE%\.codex\pets\<pet-slug> on Windows.

  3. 03

    Verify and activate in Codex

    PetDB CLI verifies SHA-256, the ZIP structure, and the manifest ID automatically. For a manual install, compare the digest and inspect pet.json, then choose the pet in Settings → Appearance → Pets.

Choose a pet to install

These are the newest reviewed Codex pets published to the catalog.

Having trouble installing?

Use the full CLI guide and troubleshooting reference for commands, package rules, and common failures.