Files
open-design/skills/hatch-pet/references/codex-pet-contract.md
T
Zakaria a46764fb1b
ci / Validate workspace (push) Has been cancelled
landing-page-ci / Validate landing page (push) Has been cancelled
landing-page-deploy / Deploy landing page (push) Has been cancelled
github-metrics / Generate repository metrics SVG (push) Has been cancelled
refresh-contributors-wall / Refresh contributors wall cache bust (push) Waiting to run
first-commit
2026-05-04 14:58:14 -04:00

788 B

Codex Pet Contract

Sprite Atlas

  • Format: PNG or WebP.
  • Dimensions: 1536x1872.
  • Grid: 8 columns x 9 rows.
  • Cell: 192x208.
  • Background: transparent.
  • Unused cells: fully transparent.

The webview animation uses CSS background positions from the fixed row and column counts. Do not add labels, gutters, borders, grid lines, shadows outside the cell, or extra frames.

Local Custom Pet Package

Place files under:

${CODEX_HOME:-$HOME/.codex}/pets/<pet-name>/
├── pet.json
└── spritesheet.webp

Manifest shape:

{
  "id": "pet-name",
  "displayName": "Pet Name",
  "description": "One short sentence.",
  "spritesheetPath": "spritesheet.webp"
}

The app loads custom pets from the folder name under ${CODEX_HOME:-$HOME/.codex}/pets/.