Ch. 4 — Notes · § 012026·05·24 · — words
Ch. 4

I Made a Desktop Panda for Codex

§ 01
COLOPHON
Source Serif 4 · JetBrains Mono · Forge Codex
TOOLS
Next 15 · MDX · framer-motion

A hands-on experiment with Codex desktop pets: using the built-in hatch-pet skill to create Panda Geek, a small desktop companion that turns agent task status into a visible, clickable entry point.

TL;DR: The Codex desktop pet is not just a cute decoration. It turns background agent work into something visible and clickable. I used the built-in hatch-pet skill to create a small panda called Panda Geek, without manually handling image processing, animation frames, or file placement.


§Background

Over the weekend, I found the desktop pet option in the Codex desktop app settings and turned it on.

It reminded me of the old /buddy experience in Claude Code. You typed /buddy in the terminal, and a small character appeared beside your work.

Codex makes the idea more practical. The pet can notify you when a task is done, bring you back to Codex when clicked, show small interactions on double click, and sometimes help you continue the current conversation.

So I wanted to test a simple question: can I make a desktop pet that feels more like mine?

The result was a panda named Panda Geek. It is quiet, focused, curious, and has a small bamboo sprout on its head. It fits the kind of companion I want on my desktop while I write, code, and build tools.

§The Short Version

If you only want to try it, you do not need to know how the pet files work.

The minimum flow is:

  1. ·Open the desktop pet settings in Codex.
  2. ·Browse the built-in pets and decide what kind of personality you want.
  3. ·Ask Codex to use the built-in hatch-pet skill to generate the pet.
  4. ·Return to the settings, refresh the pet folder, and select the new pet.

You can think of hatch-pet as Codex's built-in pet-making workflow. You describe the animal, mood, and visual style. Codex handles the pet asset process.

§Step 1: Decide the Personality First

I would not start by asking Codex to draw something.

Open the Codex desktop pet settings first and click through the built-in pets. The default set already shows a wide range of directions: some are cute, some are minimal, and some feel closer to small utility icons.

This step is about deciding what kind of presence you want on your desktop.

In my case, I did not want something loud or visually busy. I wanted something calmer, more like a quiet work companion. I spend a lot of time writing code, writing essays, and building tools, so a noisy character would become a distraction.

§Step 2: Tell Codex What You Want

You can send a prompt like this:

Help me create a Codex desktop pet.

Animal: panda
Personality: quiet, focused, curious
Style: cute, but not too busy
Requirement: use the built-in hatch-pet skill, and make it selectable from the Codex settings when done.

That is enough to start.

If you want the pet to feel more personal, add one more line:

Please add a little of my personal style based on what you know about me.

My initial request was that simple. I asked Codex to create a panda pet based on its understanding of me. The final direction was surprisingly close: a gentle-looking panda that feels right for focused work.

§Step 3: Explicitly Ask for hatch-pet

This is the important part: ask Codex to use hatch-pet.

If you only say "draw me a panda", Codex may generate a normal image. A normal image is not the same thing as a desktop pet.

A safer instruction is:

Please use the built-in hatch-pet skill to complete this. Do not only generate an image.

In plain terms, you are asking Codex to run the complete pet workflow.

Under normal conditions, Codex will place the pet where the desktop app expects it. After that, you only need to refresh the pet folder in settings.

§Step 4: Wait for the Preview and Inspect It

Do not interrupt the generation too early.

Once Codex shows the preview, check three things:

  • ·Does it look like the character you wanted?
  • ·Does the motion feel natural?
  • ·Are there any odd dots, broken edges, or background artifacts?

In my first preview, the waving animation had a small black dot beside it. It was not obvious in the large preview, but it would be distracting when scaled down on the desktop.

That is the kind of issue this workflow can run into. The pet may be generated successfully, while small visual artifacts still need a cleanup pass.

I asked Codex to fix it once. The second version kept the face, bamboo sprout, and motion, while removing the extra dot.

§Step 5: Refresh and Select the Pet

When Codex finishes, go back to the desktop pet settings.

Find the refresh action for the pet folder and run it. Then look for the pet name in the list.

In my case, the name was Panda Geek.

Select it, and the desktop pet is replaced.

If you do not see it, restart Codex and refresh the pet folder again. For a normal user, there is no need to dig through directories or understand the file structure. The practical workflow is just refresh, select, and use.

§Why This Is Interesting

The most interesting part of the Codex desktop pet is not that it is cute.

It behaves more like a lightweight task entry point.

You may be researching in a browser, writing in an editor, or working in another window while Codex runs a task in the background. When the task is done, the pet notifies you. When you click it, you return to Codex.

That gives the background agent a stronger presence than a normal notification, without forcing you to stare at the Codex window.

The double-click animations are a small detail, but they make the tool feel less cold. More importantly, the pet makes agent work visible. It gives "AI is doing something for me" a small physical anchor on the desktop.

I had a similar feeling with Claude Code's /buddy. The terminal stopped being only a stream of text and gained a small companion-like presence. Codex moves that idea into the desktop app and lets users customize it, which feels like the right direction.

§Summary

The whole workflow can be reduced to one sentence:

Open the Codex desktop pet settings, browse the built-in styles, tell Codex what pet you want, ask it to use hatch-pet, refresh the pet folder, and select the new pet.

My version is Panda Geek: a quiet, curious desktop panda with a small bamboo sprout on its head.

It now sits on my desktop while Codex works. When a task finishes, it reminds me. When I click it, I return to Codex.

This small feature may not transform productivity by itself, but it changes how an AI tool exists on the desktop: from a background window into a visible, clickable, and customizable work entry point.

SIGNED北京 · 2026·05·24 · git dev