published jun 23, 2026

Create a Custom Codex Pet (No Code Required)

beginner

The Rundown

In this guide, you will learn how to make a custom animated desktop pet like Clippy. It will sit on your screen and give you status updates from your Codex agent as it works.

Who This Is Useful For

  • Codex users who want a lightweight way to monitor active tasks without keeping the whole app open.
  • People who like customizing their workspace, but do not want to hand-build animation files or sprite sheets.
  • Teams making repeatable Codex workflows who want a small visual reminder that an agent is running, waiting, or ready to review.

What You Will Build

You will create a custom animated Codex pet, add it to the Codex desktop app, and wake it as a floating status companion.

custom codex pet
custom codex pet

Behind the scenes, the pet is more than one static image. The hatch-pet skill turns your mascot idea into the files Codex needs for different pet states and animations.

pet sprite sheet overview
pet sprite sheet overview

What You Need To Get Started

  • The Codex desktop app (https://developers.openai.com/codex/app) with the latest update
  • You could also do this in Codex terminal with /pet and @hatch-pet

Going Further

Once you have one pet working, turn the same process into a repeatable customization checklist: update the pet, tune the app theme, set your preferred Codex personality, and document project rules in AGENTS.md.

You can also browse the Petdex GitHub repo (https://github.com/crafter-station/petdex) for user-created pet inspiration. Treat outside pet files like any other community-created asset: inspect what you are installing, avoid untrusted commands, and use the gallery for ideas when you are not sure what style you want.