codex-pet
starsforks
How to install codex-pet?
prime-skills/runcomfy-agent-skills/codex-pet
$npx -y skills add prime-skills/runcomfy-agent-skills --skill codex-petCodex Pet generator on RunComfy. Build a Codex-compatible Codex Pet spritesheet.webp + pet.json from a single reference image, drop it into ${CODEX_HOME:-$HOME/.codex}/pets/<name>/ and Codex picks it up as a custom Codex Pet next to the 8 built-ins. This skill produces the exac
SKILL.md
| 1 | # Codex Pet — Pro Pack on RunComfy |
| 2 | |
| 3 | [runcomfy.com](https://www.runcomfy.com/?utm_source=skills.sh&utm_medium=skill&utm_campaign=codex-pet) · [GPT Image 2 edit endpoint](https://www.runcomfy.com/models/openai/gpt-image-2/edit?utm_source=skills.sh&utm_medium=skill&utm_campaign=codex-pet) · [docs](https://docs.runcomfy.com/cli/introduction?utm_source=skills.sh&utm_medium=skill&utm_campaign=codex-pet) |
| 4 | |
| 5 | **Codex Pet generator on RunComfy.** Turn one source image into a Codex-compatible custom Codex Pet — `pet.json` + `spritesheet.webp` — drop it into `${CODEX_HOME:-$HOME/.codex}/pets/<name>/`, Codex picks it up next to the 8 built-in Codex Pets. |
| 6 | |
| 7 | ```bash |
| 8 | npx skills add agentspace-so/runcomfy-agent-skills --skill codex-pet -g |
| 9 | ``` |
| 10 | |
| 11 | ## What a Codex Pet is |
| 12 | |
| 13 | OpenAI Codex Pets (released May 2026) are pixel-art animated companions that float over your desktop while Codex codes — they react to mouse interaction and Codex status (scratching head when thinking, popping a speech bubble when a task completes). Codex ships with 8 built-in Codex Pets and supports custom Codex Pets installed locally as a folder under `${CODEX_HOME:-$HOME/.codex}/pets/`. |
| 14 | |
| 15 | Each custom Codex Pet folder contains exactly two files: |
| 16 | |
| 17 | - `pet.json` — manifest with `id`, `displayName`, `description`, `spritesheetPath`. |
| 18 | - `spritesheet.webp` — Codex Pet sprite atlas, **1536x1872** PNG or WebP, 8 columns x 9 rows of 192x208 cells, transparent background. |
| 19 | |
| 20 | The 9 rows correspond to 9 animation states Codex plays. Each row uses a fixed number of leading frames; trailing cells stay fully transparent. |
| 21 | |
| 22 | ## Why this Codex Pet skill (vs OpenAI's official `hatch-pet`) |
| 23 | |
| 24 | OpenAI ships an official [`hatch-pet`](https://github.com/openai/skills/blob/main/skills/.curated/hatch-pet/SKILL.md) skill that produces the same Codex Pet artifact via the Codex-internal `$imagegen` system skill (requires Codex Pro + `$imagegen` configured). |
| 25 | |
| 26 | **This Codex Pet skill is a drop-in alternative that runs via the RunComfy CLI**: a single `RUNCOMFY_TOKEN` plus `runcomfy` and `magick` binaries — no Codex Pro, no `$imagegen`, no OPENAI_API_KEY. The output Codex Pet artifact is identical — same `pet.json` shape, same `spritesheet.webp` 1536x1872 atlas, same 9 animation rows — so Codex treats this Codex Pet exactly like one made by `hatch-pet`. |
| 27 | |
| 28 | This skill follows the same pattern Codex's built-in Codex Pets use: **one canonical pose, replicated across cells with ImageMagick micro-transforms** for subtle animation (1-2 px shifts, blink frames, tilt frames). That matches what the official `hatch-pet` output actually looks like cell-by-cell — the Codex Pet animation visible in the Codex desktop app is intentionally subtle. |
| 29 | |
| 30 | Pick this skill when: |
| 31 | |
| 32 | - You want a custom Codex Pet but don't have Codex Pro / `$imagegen`. |
| 33 | - You want a custom Codex Pet built via the RunComfy Model API. |
| 34 | - You want **batch Codex Pet generation** from a folder of source images (one canonical call per pet). |
| 35 | - You're entering the OpenAI Codex Pet contest with a different model behind the visuals. |
| 36 | - You said "codex pet", "/hatch", "make me a codex pet", "spritesheet.webp", "desktop pet for codex" explicitly. |
| 37 | |
| 38 | ## Codex Pet animation rows |
| 39 | |
| 40 | Codex reads one fixed atlas: 8 columns, 9 rows, 192x208 cells. Each Codex Pet row corresponds to one animation state with a specific number of leading frames. |
| 41 | |
| 42 | | Row | State | Used columns | Frames | Codex Pet behavior | |
| 43 | |---|---|---|---|---| |
| 44 | | 0 | idle | 0-5 | 6 | calm breathing/blinking; the reduced-motion first frame for the Codex Pet | |
| 45 | | 1 | running-right | 0-7 | 8 | Codex Pet locomotion to the right | |
| 46 | | 2 | running-left | 0-7 | 8 | mirrored locomotion to the left | |
| 47 | | 3 | waving | 0-3 | 4 | greeting / attention gesture | |
| 48 | | 4 | jumping | 0-4 | 5 | anticipation, lift, peak, descent, settle | |
| 49 | | 5 | failed | 0-7 | 8 | error / sad / deflated reaction | |
People who liked this also viewed
6 picksType
- ai-video-generationinference.sh Agent skills for using our API to give your agents access to hundreds of apps and other agentsSkillsJul 2026
- imagegen-frontend-webElite frontend image-direction skill for generating premium, conversion-aware website design references. CRITICAL OUTPUT RULE — generate ONE separate horizontal image FOR EVERY section. A landing pageSkillsJul 2026
- hyperframes-mediaWrite HTML. Render video. Built for agents.SkillsJul 2026
- media-useAgent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + leSkillsJul 2026
- general-videoAuthor or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, staticSkillsJul 2026
- product-launch-videoTurn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market,SkillsJul 2026
