Codex Elemental Pets

Four high-quality companions for Codex: ice, lightning, smoke and ash, and mind.

Open the interactive showcase · Get the pet pack · Read the Ultra evolved-forms proposal

Meet the pets

Frostbyte	Bolt
A cool-headed crystal companion for precise, patient work.	A bright, restless spark for rapid experiments and brave first passes.

Cinder	Mantra
A sly smoke-and-ash familiar who turns every task into a controlled burn.	A serene three-faced mind familiar who meditates through problems from three points of view.

Their personalities are built into their silhouettes and motion. Frostbyte is balanced, faceted, and composed. Bolt is asymmetric, forward-leaning, and visibly impatient to move. Cinder curls and reforms like a carefully banked ember. Mantra remains in a floating meditative stance while its three original faces embody Focus, Intuition, and Imagination.

Install

The official desktop path is the recommended method:

1. Download the drag-and-drop pet pack.
2. In Codex, open Settings → Pets → Custom pets → Open folder.
3. Copy any of the frostbyte, bolt, cinder, or mantra folders from the downloaded pack into the folder Codex opened.
4. Return to Settings → Pets, choose Refresh, then select your new companion.

See OpenAI's official Pets documentation for the current desktop, web, and CLI behavior.

The interactive showcase also provides one-click Codex desktop install links backed by the hosted v2 spritesheets.

Optional command-line installers

On macOS or Linux:

git clone https://github.com/Ashyboy219/codex-elemental-pets.git
cd codex-elemental-pets
./install.sh

On Windows PowerShell:

git clone https://github.com/Ashyboy219/codex-elemental-pets.git
cd codex-elemental-pets
./install.ps1

If a newly copied pet is not visible, use Refresh in Pets before restarting Codex.

Ultra evolved-forms concept

The showcase includes Normal and Ultra visual studies for Frostbyte and Bolt only. The proposed Ultra form is a static evolved design shown through an immediate, non-animated swap—there is no transformation sequence or ambient effect. Cinder and Mantra do not have proposed evolved forms. Ultra is an upstream concept, not current runtime behavior: Codex custom pets do not receive reasoning-effort events and currently load one atlas per pet. The v3 manifest and event proposal describes a backwards-compatible path for selecting alternate forms.

Why these are more than character stickers

Each of the four pets includes:

• a validated 1536 × 2288 transparent WebP atlas;
• 11 animation rows and 73 populated frames;
• idle, directional movement, waving, jumping, failure, waiting, active-work, and review states;
• 16 clockwise look directions with explicit cardinal, continuity, and blind-direction QA;
• spriteVersionNumber: 2 packaging for the extended custom-pet format;
• a stable identity, palette, silhouette, face, and personality across every state.

Media kit

• Frostbyte and Bolt evolved-form concept video — Reels, TikTok, and Shorts
• Frostbyte and Bolt evolved-form concept video — X, LinkedIn, and YouTube
• Four-pet vertical showcase — Reels, TikTok, Shorts, and mobile feeds
• Four-pet landscape showcase — X, LinkedIn, YouTube, and presentations
• Square launch image
• Landscape launch image
• Ready-to-post captions and launch checklist
• Prepared OpenAI Developer Showcase submission

Build notes

The pets were designed and produced through Codex using grounded image generation plus deterministic atlas assembly and validation. The social media was rendered from the final approved spritesheets; it does not redraw or replace the pet artwork.

Rebuild the installable-pet media and the Ultra evolved-form concept cut with the bundled workspace Python runtime and FFmpeg:

python3 scripts/build_media.py
python3 scripts/build_evolution_media.py

License and status

Code is MIT licensed. Pet art, animation assets, and promotional media are shared under CC BY 4.0; see ASSET-LICENSE.md.

This is an unofficial community project and is not affiliated with or endorsed by OpenAI. The custom pet format may evolve.