--
title: "What Is a Codex Pet? A Beginner's Guide to Custom Desktop Companions"
published: true
description: A Codex Pet is a pixel-art desktop companion inside OpenAI Codex. Two files, one folder, and it animates beside you while you code. Here's how to get one.
tags: ai, webdev, showdev, productivity
canonical_url: https://codexpetgenerator.com/blog/what-is-a-codex-pet
A Codex Pet is a pixel-art desktop companion that lives inside the OpenAI Codex desktop app — a tiny animated buddy that walks, jumps, and loafs around your terminal while you code.
Under the hood it's just two files:
- spritesheet.webp — one sprite sheet with every animation frame (9 states × 8 frames)
- pet.json — the animation config that tells Codex how to play each frame
Install them into ~/.codex/pets/, restart Codex, and the pet appears.
Why people love them
- A more human workspace — coding is lonely; a pixel buddy changes the vibe
- Personal expression — generate your own from a photo
- Community momentum — CodexPets lists 800+ pets already
Is it the same as an AI assistant?
No. A Codex Pet doesn't participate in code logic — it's purely visual. The AI writes your code; the pet cheers you on. They coexist.
How to get one
-
Use a ready-made one — download a community pet, unzip into
~/.codex/pets/ - Generate from a photo (recommended) — codexpetgenerator.com turns your photo into a pixel pet (spritesheet.webp + pet.json) in minutes
- Hand-craft it — draw your own sprite sheet + write pet.json. High barrier.
Top comments (0)