pet/avatar overlay feature gate blocked #20706

Activity

1. grava-claw

   added

   appIssues related to the Codex desktop appIssues related to the Codex desktop app

   on May 1, 2026
2. github-actions

   added

   bugSomething isn't workingSomething isn't working

   on May 1, 2026
3. carmelyne commented on May 2, 2026

   

   carmelyne

   on May 2, 2026

   More actions

   I may be seeing the same overlay/window issue, but with a slightly different symptom.

   I filed in-app feedback here:

   Feedback ID:
   019de4eb-644f-7ff3-a198-0f3fe1ae9e62

   In my case, /pet opens the overlay and the pet can be dragged, but only a tiny sliver is visible.

   Built-in pets and custom pets both reproduce the issue. The “Greet pet” bubble/tray is clipped too, so this does not appear to be a spritesheet/custom asset issue.

   Codex Version:
   26.429.30905 (2345)

   macOS:
   26.4.1 (25E253)

   Mac:
   Apple M1, Metal 4

   Display setup:

   • Built-in Retina LCD: 2560 x 1600 Retina, Main Display, Mirror Off
   • External display: 1680 x 1050 @ 75Hz, Mirror Off, Rotation Supported

   Observed:

   • /pet opens the overlay, but only a tiny sliver is visible.
   • The pet can be dragged.
   • The “Greet pet” bubble/tray is also clipped.
   • Built-in/default pets reproduce the same clipping.
   • Custom pet PNG/WebP does not affect the issue.
   • Saved state bounds look normal:
     • electron-avatar-overlay-bounds.width = 356
     • electron-avatar-overlay-bounds.height = 320

   Expected:
   The pet overlay window should render at its full 356 x 320 bounds, including mascot and activity bubble.

   Likely area:
   Transparent always-on-top Electron avatar overlay window rendering/clipping on macOS with multi-display setup.
4. jazzyalex commented on May 2, 2026

   

   jazzyalex

   on May 2, 2026

   More actions

   Additional data point: this is not specific to one built-in pet or one custom asset.

   I installed a known Petdex custom pet using:

   npx petdex install boba

   It installed into:

   ~/.codex/pets/boba/
     pet.json
     spritesheet.webp
   

   Codex Desktop recognizes the custom pet and it can be selected in Settings > Appearance > Pets. However, the pet still renders cut/clipped in the overlay, the same way the built-in mascots do.

   So the current behavior appears to be:

   • Built-in mascots render cut/clipped.
   • Custom pets render cut/clipped.
   • The pet selection/install path works.
   • The failure is likely in the Desktop pet/avatar overlay sizing, clipping, or window rendering path rather than in individual pet assets.
5. etraut-openai

   added

   pets

   on May 3, 2026
6. jacobcreo commented on May 4, 2026

   

   jacobcreo

   on May 4, 2026

   More actions

   I’m seeing what looks like the same pet/avatar feature area failing on the same Codex Desktop version, but with one extra clue that may help narrow it down.

   Related issue I filed: #21065

   My setup:

   • Codex Desktop 26.429.30905 / CFBundleVersion 2345
   • macOS on Apple Silicon
   • uname -mpr: 25.3.0 arm64 arm
   • ChatGPT Pro

   In my case, /pet does appear to open the avatar overlay window. I can see a second small Codex window, and the activity/status tray renders inside it. So for me it does not look like the overlay window is completely failing to open.

   The missing part is specifically the mascot/pet sprite:

   • The status/activity tray appears.
   • The selected pet/mascot is not visible anywhere.
   • Restarting Codex did not fix it.
   • Loading /pet again does not make the mascot appear.
   • A screenshot crop of the expected mascot region contains only overlay/status UI, no sprite.

   One possible packaging/rendering clue from local inspection:

   • The app bundle contains webview/assets/codex-avatar-D82knaKt.css.
   • That file defines .codex-avatar-root with what look like the required sprite rules, including width: 7.04rem, aspect-ratio: 192/208, and background-size: 800% 900%.
   • In my 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.

   So this may be two related failure modes:

   1. /pet/feature gate/overlay activation not showing anything for some users.
   2. Overlay opens, but avatar CSS is not loaded, so the pet element may render with no effective sprite sizing/background and becomes invisible.

   Hope this helps narrow it down. The feature looks great, would love to see it working.
7. purrfecto114-lgtm

   added a commit that references this issue on Jul 25, 2026

   test(territory): add Codex/ChatGPT pet identification branch coverage…

   ...

   59d8533