What Is a Codex Pet? A Beginner's Guide to Custom Desktop Companions
2026-08-04
A Codex Pet is a pixel-art desktop companion for OpenAI Codex — two files (spritesheet.webp + pet.json) in ~/.codex/pets/. Make yours with Codex Pet Generator.
What exactly is a Codex Pet?
A Codex Pet is a custom pixel companion that lives inside the OpenAI Codex desktop app. If you have ever wondered "what is a Codex Pet?", think of it as a tiny animated buddy that sits in your editor and moves around while you write code — adding personality to an otherwise plain terminal.
Under the hood, every Codex Pet is just two files: spritesheet.webp (one image holding every animation frame, 9 states x 8 frames) and pet.json (the config that tells Codex how to play each frame). Drop them into ~/.codex/pets/ and restart Codex — the pet appears.
Why people add a Codex Pet to their setup
- A more human workspace — coding is lonely; a pixel buddy makes it feel different
- Personal expression — a custom pet generated from your own photo is unique to you
- Community momentum — CodexPets and similar communities list 800+ pets, and "turn my cat into a Codex pet" posts are trending
- Free to start — the Codex Pet Generator Starter plan gives 3 free generations
Is a Codex Pet the same as an AI coding assistant?
No. A Codex Pet does not participate in your code logic — it is purely visual companionship. The AI assistant does the real work; the pet is the morale support on your desktop. They coexist: the AI writes your code, the pet cheers you on.
How do you get a Codex Pet?
- Use a ready-made one — download a community pet package and unzip it into ~/.codex/pets/
- Generate from a photo (recommended) — open Codex Pet Generator, upload a photo, let the AI turn it into a pixel pet, download the ZIP, unzip and install. Takes minutes, no design skills.
- Hand-craft it — draw your own sprite sheet and write pet.json. High barrier, not recommended for beginners.
How to install a Codex Pet
1) Download the pet package ZIP. 2) Unzip to get a my-pet/ folder (spritesheet.webp + pet.json inside). 3) Move it to ~/.codex/pets/my-pet/. 4) Fully restart Codex — the pet appears.
For a full walkthrough with macOS and Windows commands, see our guide on installing a custom Codex pet.
Frequently asked questions
Does a Codex Pet use extra system resources?
No. It only plays a small sprite animation, so the overhead is negligible and will not slow down your editor.
Can I rename or recolor my Codex Pet?
Partially. Basic customization is covered in our custom Codex pet guide; deeper edits are possible by editing pet.json on paid plans.
Does every OpenAI Codex version support pets?
Most desktop builds support the ~/.codex/pets/ folder. Always check the official OpenAI Codex docs for your specific version.
Does generating a Codex Pet cost money?
The Starter plan is free and includes 3 generations. The Pro plan is $9/month and adds 15 generations plus HD spritesheets.
What is the difference between a Codex Pet and a custom Codex Pet?
A regular Codex Pet can be a community download. A custom Codex Pet is generated from your own photo or artwork so it looks like your pet, avatar, or brand.
Related posts
Try it yourself
Ready to turn your own photo into a pixel-art pet? Upload it on PetGen and get your spritesheet + pet.json in minutes.
Generate your pet now →