/pet opens overlay/status tray but no pet mascot is visible

Open 💬 1 comment Opened May 4, 2026 by jacobcreo

What version of the Codex App are you using (From “About Codex” dialog)?

26.429.30905 (CFBundleVersion 2345)

What subscription do you have?

ChatGPT Pro

What platform is your computer?

25.3.0 arm64 arm / macOS on Apple Silicon

What issue are you seeing?

<img width="1293" height="1072" alt="Image" src="https://github.com/user-attachments/assets/0d0b269b-3858-46ec-bf3f-4231f7109316" />

When I run /pet in Codex Desktop, it opens the pet/avatar overlay window, but the actual pet mascot is not visible.

What does work:

  • /pet opens a second small Codex overlay window.
  • The activity/status tray renders inside that overlay.
  • The overlay shows current Codex activity/status.

What does not work:

  • No pet/mascot sprite appears anywhere in the overlay.
  • Restarting Codex did not fix it.
  • Loading /pet again does not make the mascot appear.
  • I also have a custom pet installed under ~/.codex/pets/blink, but the issue appears to affect the mascot rendering generally, not only the custom pet.

Observed result:
The overlay/status tray appears, but the pet itself is invisible.

Additional local investigation:

  • The Codex app bundle contains built-in pet spritesheets.
  • My custom pet spritesheet validates as a 1536x1872 RGBA WebP atlas.
  • The overlay window exists and has the expected approximate size.
  • A screenshot crop of the expected mascot region contains only the overlay/status UI, not the mascot.
  • The app bundle contains webview/assets/codex-avatar-D82knaKt.css, which defines .codex-avatar-root.
  • That CSS appears to contain the required avatar sizing/background rules:
  • aspect-ratio: 192/208
  • width: 7.04rem
  • background-repeat: no-repeat
  • background-size: 800% 900%
  • However, in this installed bundle, webview/index.html links several CSS files but does not appear to link codex-avatar-D82knaKt.css.
  • avatar-overlay-page-Dj9Zinq_.js imports codex-avatar-BpKnWN_W.js, but that JS chunk does not appear to import the avatar CSS.

Suspected cause:
The avatar overlay may be rendering the mascot element without loading codex-avatar-D82knaKt.css, causing .codex-avatar-root to have no effective dimensions/background sizing, so the pet sprite is invisible even though the overlay window and status tray render.

What steps can reproduce the bug?

Uploaded thread: 019df448-6f4e-7ac1-aa62-b7e681236b971. Open Codex Desktop on macOS.

  1. Start or open any Codex thread.
  2. Run /pet.
  3. Observe that a second small Codex overlay/status window opens.
  4. Observe that the status/activity tray renders.
  5. Look for the pet/mascot in the overlay.

Actual result:
Only the activity/status tray is visible. The pet/mascot sprite does not appear.

Expected result:
The selected Codex pet/mascot should be visible in the overlay.

This reproduced after restarting Codex.

Uploaded thread: 019df448-6f4e-7ac1-aa62-b7e681236b97

What is the expected behavior?

Running /pet should show the floating Codex pet/avatar mascot on screen, together with any status/activity UI.

The pet should be visible and animated, using either the default selected pet or a custom installed pet if one is selected.

Additional information

I attached a screenshot showing the overlay/status tray visible but no mascot.

Local app details:

  • Codex Desktop version: 26.429.30905
  • CFBundleVersion: 2345
  • Platform: macOS / Apple Silicon
  • uname -mpr: 25.3.0 arm64 arm

I also verified that the overlay window exists separately from the main Codex window. The problem seems to be mascot rendering, not /pet failing to open the overlay.

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗