# Install Owly in Codex

Owly is SparkleTree's forest-green baby owl, with a mint face, teal wings, and a stitched branching-tree heart.

## Package

- Manifest: https://sparkletree.io/pets/owly/pet.json
- Sprite sheet: https://sparkletree.io/pets/owly/spritesheet.webp
- Pet ID and installation folder: `sparkletree-owly`
- Display name: `Owly`
- Sprite version: `2`
- Transparent WebP atlas: 1536 × 2288 pixels, eight columns and eleven rows.

This package contains only a JSON manifest and artwork. No installer or generated replacement artwork is needed.

## Install

1. Download both files to a temporary directory. Check that the manifest is valid JSON, its ID is `sparkletree-owly`, its `spriteVersionNumber` is `2`, and its `spritesheetPath` is `spritesheet.webp`. Check that the image is a valid WebP with the dimensions above. Stop if either download fails or contains an HTML error page.
2. Resolve the user's Codex home: use `CODEX_HOME` when set, otherwise `.codex` inside the user's home directory. Use the equivalent paths on Windows.
3. Create `pets/sparkletree-owly/` inside that directory and place `pet.json` and `spritesheet.webp` together there. Preserve the supplied manifest. If this folder already exists, compare the files and back it up before replacing different contents. Leave other pets unchanged.
4. Refresh the custom pets list in Codex Settings > Pets. Select **Owly** and enable **Show pet**. The `/pet` command also toggles the floating pet.
5. Verify that Owly is selected and visible. If the agent cannot operate these app controls, ask the user to finish step 4; don't claim activation succeeded without verifying it. If the app doesn't show the new pet after refreshing, restart the app and check Settings > Pets again.

The website button opens a new Codex task with an installation prompt. The user presses Send to run it. Codex's usual file and network permissions still apply.

Pet controls can vary by app version. See the [official pet documentation](https://learn.chatgpt.com/docs/pets).