first-commit

2026-05-04 14:58:14 -04:00
commit a46764fb1b
1210 changed files with 233231 additions and 0 deletions
@@ -0,0 +1,35 @@
+# 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:
+
+```text
+${CODEX_HOME:-$HOME/.codex}/pets/<pet-name>/
+├── pet.json
+└── spritesheet.webp
+```
+
+Manifest shape:
+
+```json
+{
+  "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/`.