Luna Codex Pet

Luna is a custom animated Codex pet based on Josh's real rabbit: a long, low white-and-gray lionhead-mix rabbit with a low dewlap-cushioned head, compact steep tucked loaf, long hind feet that kick through motion, mottled gray saddle patches, a white blaze, dark eye mask, quirky left eye, and expressive ears.

What Makes Luna Special

• Full Codex pet atlas: 1536x1872, 8 columns by 9 rows, 192x208 cells.
• Nine enriched states: idle, running-right, running-left, waving, jumping, failed, waiting, running, and review.
• Version 2 fills all 8 cells in every row, adding 15 previously-empty in-between frames and bonus loop frames.
• Rabbit-specific animation rules: forefeet reach/land, hindquarters load, long hind feet kick through toe-off, flight, and recovery.
• Accurate loaf anatomy: low head on dewlap, tucked front feet, compact steep gray haunch when hind legs are folded.
• No generic paw/arm shapes: feet stay rabbit-specific and only appear where motion requires them.
• Video-grounded interaction rules for chat/feed states: loaf, wait, inspect, sniff, hop, peek, and settle.
• Public-safe package: generated pet assets and docs only. Original private reference media is not included.

Preview

Open index.html locally, or use GitHub Pages once enabled for this repo.

Per-state GIF previews are in assets/previews:

State	Preview
idle
running-right
running-left
waving
jumping
failed
waiting
running
review

Install In Codex

Copy the package files into your Codex pets directory:

mkdir -p ~/.codex/pets/luna
cp pet.json ~/.codex/pets/luna/pet.json
cp assets/spritesheet.webp ~/.codex/pets/luna/spritesheet.webp

The loadable runtime files are:

pet.json
assets/spritesheet.webp

Validation

The installed build passed the Luna v2 full-row validator:

{
  "ok": true,
  "width": 1536,
  "height": 1872,
  "errors": [],
  "warnings": [],
  "transparent_rgb_residue_pixels": 0
}

See qa/installed-validation.json and qa/qa-review.json.

Documentation

• docs/ANIMATION-SPEC.md - state contract and anatomy locks.
• docs/FEATURES.md - state behavior map.
• docs/ITERATION-2026-06-28.md - v2 enrichment notes.
• docs/IDENTITY-GUIDE.md - Luna identity preservation rules.
• docs/LUNA-REFERENCE-ANALYSIS.md - distilled reference/photo analysis without publishing source photos.
• docs/LUNA-BEHAVIOR-EVIDENCE.md - video-grounded chat/feed interaction contract without publishing source videos.
• docs/capabilities.json - machine-readable state and anatomy metadata.

License

MIT.