This repository is the shared home for original Codex pets, their runtime
packages, source artwork, previews, audits, and maintenance tools. Every pet is
self-contained under pets/<pet-id>/ and registered in catalog.json.
| Pet | Status | Preview |
|---|---|---|
| CRT Monitor | Stable · 88 audited frames | 8×11 contact sheet |
| AI Pulse | Stable · 88 audited frames | 8×11 contact sheet |
List available pet ids in catalog.json, then install one:
./scripts/install.sh <pet-id>On Windows PowerShell:
./scripts/install.ps1 -PetId <pet-id>Restart Codex, then choose the pet in Settings → Appearance → Pets. Omitting the id still installs CRT Monitor for backward compatibility.
python3 scripts/validate.py --allGenerate a selected pet's native-resolution contact sheet and frame audit:
python3 scripts/generate-preview-and-audit.py crt-monitorEach pet also preserves confirmed original inputs and a lossless RGBA editing
master under pets/<pet-id>/assets/source/. README cards and generated previews
are presentation assets and must not be used as future editing sources.
See the repository architecture before adding a pet.
The original root pet/ runtime and selected root assets/ files remain as
byte-identical CRT Monitor compatibility mirrors. External links—including the
existing Awesome Codex Pet listing—therefore keep working. New pets use only
the canonical pets/<pet-id>/ layout.
Code and scripts are licensed under the MIT License. Each pet carries its own artwork license; see the license file inside each pet directory.