Issue Station
Sign In
Tools hereToolbox

codex - 💡(How to fix) Fix Codex Pets overlay clips/mispositions sprite and notification tray on macOS [1 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openai/codex#20831•Fetched 2026-05-03 04:44:41
View on GitHub
Comments
1
Participants
2
Timeline
3
Reactions
0
Author
KaishuShitoKaishuShito
Participants
github-actions[bot]github-actions[bot]KaishuShitoKaishuShito
Timeline (top)
labeled ×2commented ×1

Codex Pets can render correctly only after dragging the floating pet overlay far away from the screen edge, but the notification tray/card remains clipped by the overlay window bounds.

This affects both built-in pets and custom pets. At first it looked like the pet sprite was missing, but dragging the floating overlay to the upper-left made the sprite visible. Mission Control shows that the pet overlay is a small fixed-size floating window, and the notification card/text is clipped inside that window instead of resizing, wrapping within bounds, or expanding the overlay window.

Root Cause

Codex Pets can render correctly only after dragging the floating pet overlay far away from the screen edge, but the notification tray/card remains clipped by the overlay window bounds.

This affects both built-in pets and custom pets. At first it looked like the pet sprite was missing, but dragging the floating overlay to the upper-left made the sprite visible. Mission Control shows that the pet overlay is a small fixed-size floating window, and the notification card/text is clipped inside that window instead of resizing, wrapping within bounds, or expanding the overlay window.

RAW_BUFFERClick to expand / collapse

Summary

Codex Pets can render correctly only after dragging the floating pet overlay far away from the screen edge, but the notification tray/card remains clipped by the overlay window bounds.

This affects both built-in pets and custom pets. At first it looked like the pet sprite was missing, but dragging the floating overlay to the upper-left made the sprite visible. Mission Control shows that the pet overlay is a small fixed-size floating window, and the notification card/text is clipped inside that window instead of resizing, wrapping within bounds, or expanding the overlay window.

Environment

  • Codex app: 26.429.30905
  • Codex CLI: 0.128.0-alpha.1
  • macOS: 26.4.1 (Darwin 25.4.0)
  • Machine/GPU: Apple M4 Max, Metal 4
  • Display: built-in Liquid Retina XDR, 3456 x 2234 Retina
  • Locale/text: Japanese UI/text

Steps to reproduce

  1. Open the Codex macOS app.
  2. Wake the pet with /pet or the Wake Pet command.
  3. Select either a built-in pet, such as bsod, or a custom pet.
  4. Place the pet overlay near the screen edge or bottom/right area.
  5. Observe that the pet may appear invisible or partially missing.
  6. Drag the pet overlay far toward the upper-left or more central screen area.
  7. Observe that the pet sprite appears, but the notification tray/card is still clipped horizontally.
  8. Open Mission Control and observe the floating pet overlay window bounds.

Expected behavior

The floating pet overlay window should be sized and positioned so that:

  • the selected pet sprite is visible within screen bounds;
  • the notification tray/card is fully visible;
  • long text, including Japanese text, wraps/clamps inside the card or the overlay resizes/repositions to avoid clipping;
  • screen edge placement does not cause the sprite/card to disappear behind the transparent window bounds.

Actual behavior

  • Near screen edges, the pet can look invisible or clipped.
  • After dragging the overlay to the upper-left, the pet sprite becomes visible, confirming the sprite loads correctly.
  • The notification card remains clipped horizontally.
  • Mission Control reveals a small fixed-size floating overlay window; the notification card extends beyond that window and gets clipped.

Things tried

  • /pet toggle
  • app restart
  • Mac restart
  • clearing saved electron-avatar-overlay-bounds
  • clearing Codex GPU/drawing caches: GPUCache, DawnGraphiteCache, DawnWebGPUCache, and Code Cache
  • testing both built-in pet (bsod) and custom pet
  • testing custom pet spritesheet as WebP and PNG

These did not resolve the clipping. Dragging the overlay to a different part of the screen was the only thing that made the sprite visible.

Screenshots

Pet becomes visible after dragging to the upper-left:

Pet visible after dragging upper-left

Notification card text is clipped horizontally:

Notification card clipped

Mission Control shows the overlay window clipping the card:

Overlay window clips card

Wider Mission Control context:

Mission Control overlay bounds

extent analysis

TL;DR

The issue can be mitigated by adjusting the floating pet overlay window size or position to ensure the pet sprite and notification card are fully visible within screen bounds.

Guidance

  • Verify that the issue persists across different pets and custom sprites to confirm it's not specific to a particular asset.
  • Investigate the Codex app's window management and resizing logic to see if the floating overlay can be dynamically sized based on its content.
  • Check if there are any configuration options or commands (like /pet) that can influence the overlay's size or position.
  • Consider testing with different screen resolutions or display settings to see if the issue is related to the specific display configuration.

Example

No specific code example can be provided without more information on the Codex app's internal workings, but adjusting the overlay window's size or position programmatically could look something like this:

// Hypothetical example, actual implementation depends on the app's framework and logic
const overlay = document.getElementById('pet-overlay');
overlay.style.width = 'auto'; // or a specific width that ensures the content fits
overlay.style.height = 'auto'; // or a specific height that ensures the content fits

Notes

The provided screenshots and Mission Control views suggest a fixed-size overlay window is the root cause. However, without access to the Codex app's source code or more detailed documentation on its behavior, the exact solution remains speculative.

Recommendation

Apply a workaround by manually adjusting the overlay's position and size if possible, or wait for an update that addresses the issue, as there's no clear indication of a version that fixes this problem.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

FAQ

Expected behavior

The floating pet overlay window should be sized and positioned so that:

  • the selected pet sprite is visible within screen bounds;
  • the notification tray/card is fully visible;
  • long text, including Japanese text, wraps/clamps inside the card or the overlay resizes/repositions to avoid clipping;
  • screen edge placement does not cause the sprite/card to disappear behind the transparent window bounds.
#container setup#orchestration issue#cache issue#memory leak#API versioning

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING