What Is a Codex Pet? A Beginner's Guide to Custom Desktop Companions

--
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

1. A more human workspace — coding is lonely; a pixel buddy changes the vibe
2. Personal expression — generate your own from a photo
3. 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

1. Use a ready-made one — download a community pet, unzip into ~/.codex/pets/
2. Generate from a photo (recommended) — codexpetgenerator.com turns your photo into a pixel pet (spritesheet.webp + pet.json) in minutes
3. Hand-craft it — draw your own sprite sheet + write pet.json. High barrier.

Install in one line