Custom Codex pet assets.

• pets/glitch-418x/ - Glitch 418x, a tiny hacker-daemon familiar based on the Glitch skull avatar.
• pets/t3-sahur/ - Tung Tung Tung Sahur, a tiny wooden sahur mascot with a bat.

Each pet folder keeps the installable Codex package at the folder root:

avatar.json
pet.json
spritesheet.webp

QA evidence lives beside the package under qa/ and final/.

• Copy the pet package into your Codex home, replacing <pet-id> with the folder name above:

  mkdir -p "$HOME/.codex/avatars/<pet-id>"
  cp "pets/<pet-id>/avatar.json" "$HOME/.codex/avatars/<pet-id>/avatar.json"
  cp "pets/<pet-id>/spritesheet.webp" "$HOME/.codex/avatars/<pet-id>/spritesheet.webp"
  
  mkdir -p "$HOME/.codex/pets/<pet-id>"
  cp "pets/<pet-id>/pet.json" "$HOME/.codex/pets/<pet-id>/pet.json"
  cp "pets/<pet-id>/spritesheet.webp" "$HOME/.codex/pets/<pet-id>/spritesheet.webp"

• Open Codex Settings and go to Appearance > Pets.

• Refresh custom pets, then select the pet you just copied.

• If the overlay is already open, toggle /pet off and on after selecting.

See the Codex settings docs — /pet only wakes or hides the floating overlay for the selected pet.