Codex pets guide

Install Codex Pets

A finished Codex pet is a folder that contains pet.json and spritesheet.webp. CodingPets.dev publishes install metadata so the CLI can place the pack where Codex expects it, then you can select it from Settings > Appearance > Pets inside the Codex app.

CLI install

$ npx codingpets install cp_example

The command downloads the public pack, writes it into the local Codex pets folder, and keeps the manifest and spritesheet paired.

Choose it in Codex

Open Codex Settings, go to Appearance, then Pets. Refresh custom pets if needed, select the new companion, and use /pet to wake it in your workspace.

Wake or hide the pet

The common commands and controls people search for are /pet, Wake Pet, and Tuck Away Pet. They bring the companion into the floating overlay or hide it when you want a quieter coding session.

Status language

Codex pets can signal running work, waiting for input, ready for review, failed tasks, and idle moments. That status vocabulary helps searchers understand why the pet changes animation while Codex works.

Manual install

~/.codex/pets/example-pet/
  pet.json
  spritesheet.webp

If you install by hand, keep the folder id, pet.json id, and spritesheetPath aligned.

CodingPets.dev is an independent custom Codex pets generator and gallery. It is not affiliated with OpenAI.