A friendly plum-and-black spider with bright curious eyes and a fine silver thread. Silk scuttles on jointed legs, greets with paired forelegs, weaves a little loop while waiting, and turns the finished loop from side to
A bright-eyed mushroom with a purple cap, glowing teal gills and little root feet. Prompt waddles, taps its roots while waiting, tips its cap in greeting, and lifts the brim to peek at the world with curiosity.
An ivory octopus robot with a teal face and warm amber eyes. Its flexible cable tentacles tap in sequence, curl into a friendly arch, sort themselves into tidy loops, and come together for a careful inspection.
A gentle little stone golem with mossy eyebrows and warm amber eyes. Pebble settles its stacked blocks, takes determined heavy steps, readjusts its shoulder stones, and peeks into a softly glowing chest seam.
A curious teal beetle technician with bright orange shell panels and round goggles. Patch scuttles on articulated legs, inspects a tiny screwdriver, polishes its shell, and greets you with a cheerful tool salute.
Codex pets are currently supported on macOS and Windows.
The website and CLI read the same catalog, so command installs and manual downloads stay consistent.
1
Copy a command
Run npx petscodex install byte. The installer resolves the package by slug and places the pet files for you.
2
Download manually
Use a pet card download button to get a zip, inspect it, unzip it, and move the pet folder into your Codex pets directory.
3
Activate in Codex
After either method, open Codex desktop and select the pet in Settings > Appearance > Pets.
Install pet
Codex pets are currently supported on macOS and Windows.
Option 1: Fast CLI install
Copy this command and run it in your terminal. This installs the pet files for you.
npx petscodex install pet
Command copied. Paste it in your terminal.
Option 2: Manual zip import
Use this if you prefer to inspect and place the files yourself.
1Download the zip package and unzip it. The folder contains pet.json and spritesheet.webp.
2
Move the unzipped pet folder into your Codex pets directory. macOS: ~/.codex/pets/<pet-id>Windows: %USERPROFILE%\.codex\pets\<pet-id>
Activate after either method: open Codex desktop and choose the pet in Settings > Appearance > Pets. Restart Codex first if the new pet does not appear.