CPCodex Pets
Back to gallery

Codex pet package

Tilly

A fluffy long-haired calico kitty with a white chest ruff, pink nose, green-yellow eyes, and calm curious expression.

animalanimalcatcutesoftcalico
Download packageSpritesheetAdvanced URL test

PetWidget + SpriteAnimator

Tilly 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 Tilly

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

Download package
npx @eyichan/codexpets add tilly

pet.json

Manifest

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

{
  "id": "tilly",
  "displayName": "Tilly",
  "description": "A fluffy long-haired calico kitty with a white chest ruff, pink nose, green-yellow eyes, and calm curious expression.",
  "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 tilly-codex-pet.zip
mkdir -p "$HOME/.codex/pets/tilly"
unzip -o "./tilly-codex-pet.zip" -d "$HOME/.codex/pets/tilly"

# In Codex
/pet

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

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 Tilly

  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.