Pet pack install

How to install a downloaded Codex Pet pack

A downloaded Codex Pet pack should be placed in the local pets folder with its manifest and spritesheet intact.

One-command install

The black command box on each pet detail page is a one-command installer. Click **Copy**, paste it into your terminal, and it will download, create the target folder, and unzip the pet package.

curl -L "https://codexpet.xyz/downloads/codie.zip" -o "/tmp/codie.codex-pet.zip" && mkdir -p "$HOME/.codex/pets/codie" && unzip -o "/tmp/codie.codex-pet.zip" -d "$HOME/.codex/pets/codie"

The command downloads the zip into /tmp, creates ~/.codex/pets/codie, and unzips pet.json and spritesheet.webp into that folder.

Switch pets in Codex Desktop

1. Copy the one-command installer from a pet detail page.
2. Paste and run it in your terminal.
3. Confirm the target folder contains pet.json and spritesheet.webp.
4. Fully quit and reopen Codex Desktop so it scans the local pets folder again.
5. Open the Codex Desktop menu and go to **Appearance / Pets**.
6. Choose the pet you installed, such as Codie or Clippy.

Manual install

You can also do the same steps by hand:

1. Download the pet zip.
2. Create the target folder, for example ~/.codex/pets/codie.
3. Unzip pet.json and spritesheet.webp into that folder.
4. Restart Codex Desktop.
5. Open **Appearance / Pets** and switch to the installed pet.

Download sample packs from Codie or Clippy download sample packs.