codex-pet-cli

Install animated pets for the Codex CLI in one command.

npx codex-pet-cli add fox

Pets land in ~/.codex/pets/<name>/ (pet.json + spritesheet) — exactly where Codex looks.

Commands

| | | | --- | --- | | codex-pet-cli add <name> | Install a pet from codex-pet.com. | | codex-pet-cli add <url> | Install from a codex-pet.com URL. Pass --trust to allow other origins. | | codex-pet-cli login | Sign in via the codex-pet website (device-code flow). | | codex-pet-cli logout | Clear stored credentials. | | codex-pet-cli whoami | Show signed-in user. | | codex-pet-cli submit <path> | Submit a pet folder, .zip, or a parent directory of pet folders. | | codex-pet-cli --version | Print version. | | codex-pet-cli --help | Show help. |

Where pets live

~/.codex/pets/
  fox/
    pet.json
    spritesheet.webp

Submitting a pet

After codex-pet-cli login, point submit at a pet folder containing pet.json and spritesheet.{webp,png} (≥ 256×256):

npx codex-pet-cli submit ~/.codex/pets/fox

You can also submit many pets at once by passing a parent directory:

npx codex-pet-cli submit ~/.codex/pets

Submissions enter a moderation queue and appear on the site after review.

Uninstall a pet

rm -rf ~/.codex/pets/fox

License

MIT.