# CodexPetHub guides for OpenAI Codex pets

> Install, publish, and package OpenAI Codex pets with CodexPetHub. Read the short guides for the install prompt, publish prompt, and pet.json + spritesheet.webp format.

- Canonical page: https://codexpethub.com/docs

Three short guides for OpenAI Codex pets: install, publish, and the package format. Each one lives at a stable URL and ships a markdown alternate so Codex and other agents can read it directly.

## Guides

- [Install an OpenAI Codex pet with Codex](https://codexpethub.com/docs/install-with-codex) — Run npx --yes codexpethub install <slug> (or paste it into Codex), then refresh Codex Settings → Appearance → Pets. The CLI downloads the manifest, verifies every SHA-256, and writes pet.json + spritesheet.webp.
- [Publish an OpenAI Codex pet with Codex](https://codexpethub.com/docs/publish-with-codex) — CodexPetHub does not accept browser uploads. Publish an OpenAI Codex pet through Codex via a short-lived publish intent or a trusted-agent HMAC API key. The codexpethub skill is required only for publishing — installing pets uses the npx --yes codexpethub install CLI.
- [The OpenAI Codex pet package format](https://codexpethub.com/docs/pet-format) — An OpenAI Codex pet is a pet.json metadata file plus a spritesheet.webp animation atlas. This guide documents the canonical shape, dimensions, license policy, and validation rules.

## Agent instructions

Each guide ships a markdown alternate at /docs/{slug}.md. Codex should prefer those over the HTML page.