CPCodex Pets
Back to gallery

Codex pet package

Chonk

A chubby black cat Codex pet with big green eyes, a tiny pink nose, and playful desktop animations.

animalcatblack-catgreen-eyestiny-pink-nosechubby
Download packageSpritesheetAdvanced URL test

PetWidget + SpriteAnimator

Chonk live preview

Switch animation rows, tune scale, and test floating behavior before installing this Codex pet locally.

Floating mode uses viewport bounds.

State previews

See every Codex pet state at once.

Use the grid to check whether the shared 8 by 9 atlas has complete idle, movement, waiting, failed, and review animation rows.

Idle
Run right
Run left
Waving
Jumping
Failed
Waiting
Running
Review

Download package

Install Chonk

Download the zip package, or copy a community CLI or curl command that installs this Codex pet into $HOME/.codex/pets/chonk. Then enable it with /pet or Settings -> Appearance -> Pet.

Download package
npx @eyichan/codexpets add chonk

pet.json

Manifest

Save this file as pet.json inside the local package folder for this Codex pet.

{
  "id": "chonk",
  "displayName": "Chonk",
  "description": "A chubby black cat Codex pet with big green eyes, a tiny pink nose, and playful desktop animations.",
  "spritesheetPath": "spritesheet.webp"
}

Atlas

Spritesheet contract

1536 x 1872 px8 columns x 9 rows192 x 208 px cells72 frames

Use the preview controls above to check idle, movement, waiting, failed, and review rows before installing.

Local install snippet
# After downloading chonk-codex-pet.zip
mkdir -p "$HOME/.codex/pets/chonk"
unzip -o "./chonk-codex-pet.zip" -d "$HOME/.codex/pets/chonk"

# In Codex
/pet

# Or manually
Settings -> Appearance -> Pet -> choose chonk

Download the package zip first, then run this command from the folder that contains the zip file. After installation, use /pet or open Settings, choose Appearance, then Pet.

Need help?

Ask AI to add this pet.

Not sure how to use this pet in Codex? Copy this AI prompt and ask your assistant to add and enable this existing pet for you.

It installs and enables this pet only. It will not generate a new pet.

How to use

How to use Chonk

  1. 01

    Review every state

    Scan the 9-state preview grid to confirm the spritesheet covers idle, movement, waving, failed, waiting, and review states.

  2. 02

    Download the package files

    Download the package zip, or save spritesheet.webp and pet.json into a folder named after this pet id.

  3. 03

    Install locally

    Copy both files into ~/.codex/pets/<pet-id>/ so Codex can discover the custom pet package.

  4. 04

    Open it in Codex

    Use /pet inside Codex, or open Settings -> Appearance -> Pet and choose this installed pet.