Skip to content
CodexPetDB

Pet download and install

Install a Codex pet in one command.

Choose a pet, copy one verified command, and CodexPetDB handles the package safely.

Install result preview

A Tom desktop pet preview

A Tom is ready for Codex

Install:

Installed to

pet.json356 BVerified
spritesheet.png1.3 MBReady
codexpetdb:~$ npx codexpetdb install 'a-tom' Fetching the verified package… SHA-256 verified. pet.json checked. Installed to ~/.codex/pets/a-tom A Tom is ready for Codex.
Package version
r2
Package size
1.3 MB
SHA-256
4ecb3f6ffe9d4450b7693f27f25f8800eb2fa3ed1dec4e03e60ff0deaa2940fc

Other installation methods

Choose the path that fits your workflow.

curl

Scripts and remote shells on macOS, Linux, or Windows.

set -e
TMP="${TMPDIR:-/tmp}"
curl -fL 'https://cdn.codexpetdb.com/revisions/019f83b6-2d6d-75fd-9369-3f9f24bdb861/a-tom.zip' -o "$TMP/a-tom.zip"
EXPECTED_SHA256='4ecb3f6ffe9d4450b7693f27f25f8800eb2fa3ed1dec4e03e60ff0deaa2940fc'
ACTUAL_SHA256="$(shasum -a 256 "$TMP/a-tom.zip" | awk '{print $1}')"
if [ "$ACTUAL_SHA256" != "$EXPECTED_SHA256" ]; then
  rm -f "$TMP/a-tom.zip"
  echo 'SHA-256 mismatch; package was not extracted.' >&2
  exit 1
fi
mkdir -p ~/.codex/pets/a-tom
unzip -oq "$TMP/a-tom.zip" -d ~/.codex/pets/a-tom
curl installation guide