Codex pet package

Boxcat

A tiny cardboard box cat Codex pet for cozy coding sessions, with animated desktop companion states.

Download package SpritesheetAdvanced URL test

PetWidget + SpriteAnimator

Boxcat live preview

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

AnimationScalePin

Floating mode uses viewport bounds.

Before you choose

Shape, movement and small-screen readability

Boxcat keeps a cardboard box as its main silhouette. Only the head, paws and box angle change prominently, making the container part of every state rather than an occasional accessory.

A contained wave

The waving row raises one paw above the rim while the box stays beneath the cat. The jump lifts the entire box; it does not switch to an exposed full-body cat.

Failure is a sinking motion

The failed row lowers the face behind the rim and adds tears. Waiting mostly changes the eyelids. The difference is easiest to see by comparing head height against the top edge of the box.

Before choosing

Directional movement tilts the box from side to side. Choose this if a broad, stable outline matters more than visible leg movement, and check that the small facial details remain readable at your chosen scale.

Compare with Mochi: Mochi shows exposed paws and a stretched running body; Boxcat preserves the box outline throughout movement.

Visual review by Codex Pets Team. Original atlas rows inspected on 2026-09-14. How we review pets. These are visual observations, not an installation test or a license grant. Use the state previews below to check your preferred size.

State previews

See every Codex pet state at once.

Use the grid to check the nine standard action rows: idle, movement, waiting, failed, and review.

Idle

Run right

Run left

Waving

Jumping

Failed

Waiting

Running

Review

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.

Download package

Install Boxcat

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

Download package

npx @eyichan/codexpets add boxcat

pet.json

Manifest

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

{
  "id": "boxcat",
  "displayName": "Boxcat",
  "description": "A tiny cardboard box cat Codex pet for cozy coding sessions, with animated desktop companion states.",
  "spritesheetPath": "spritesheet.webp"
}

Assets

Package files

Package ZIP: Download ZIP
Spritesheet URL: /pets/boxcat/spritesheet.webp
Manifest URL: /pets/boxcat/pet.json
Author: railly. Attribution identifies the catalog contributor; it does not grant a license to third-party characters or artwork. Report a rights or attribution concern.

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 boxcat-codex-pet.zip
mkdir -p "$HOME/.codex/pets/boxcat"
unzip -o "./boxcat-codex-pet.zip" -d "$HOME/.codex/pets/boxcat"

# In Codex
/pet

# Or manually
Settings -> Appearance -> Pets -> choose boxcat

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 Pets. Use Refresh custom pets if the package does not appear immediately.

How to use

How to use Boxcat

01
Review every state
Scan the 9-state preview grid to confirm the spritesheet covers idle, movement, waving, failed, waiting, and review states.
02
Download the package files
Download the package zip, or save spritesheet.webp and pet.json into a folder named after this pet id.
03
Install locally
Copy both files into ~/.codex/pets/<pet-id>/ so Codex can discover the custom pet package.
04
Open it in Codex
Use /pet inside Codex, or open Settings -> Appearance -> Pets and choose this installed pet. Refresh custom pets if it is not listed yet.