Add usage-limit rings to the /pet avatar overlay or expose a decoration hook

Resolved 💬 0 comments Opened May 7, 2026 by SGT-Cho Closed May 7, 2026

What variant of Codex are you using?

App

What feature would you like to see?

I would like Codex App's /pet avatar overlay to support usage-limit ring decorations directly inside the avatar overlay window, or expose an official decoration/extension hook that lets companion tools render around the mascot inside the same overlay.

A useful built-in version would show two optional rings around /pet:

  • a primary short-window usage ring, such as the 5h limit
  • a secondary longer-window usage ring, such as the weekly limit

The rings should be part of the existing avatar overlay renderer/window, so they move, drag, clamp, hide, and resize together with the pet. Ideally this would also work with custom pets by sizing from the current mascot bounds.

The feature could include a small set of preferences:

  • enable/disable usage rings
  • show rings always or only on hover
  • customize ring colors/opacity
  • show tooltip/readout text on hover, for example 5h 72% and weekly 41%

Additional information

I experimented with a separate native macOS companion overlay that reads Codex App's avatar bounds and draws rings in a separate transparent window. That approach works, but it exposes a structural limitation: because the pet and rings are separate windows, drag synchronization and z-order can never be as reliable as drawing the rings inside the existing /pet Electron overlay.

The installed app already appears to publish useful overlay state, including electron-avatar-overlay-open and electron-avatar-overlay-bounds, and the avatar overlay window itself handles mascot layout, dragging, pointer pass-through, and custom pet sizing. That makes the existing overlay the most natural place for this UI.

This request is mainly about avoiding fragile external overlays and giving usage/status decorations a supported path that stays visually attached to /pet across drag, resize, display changes, and future Codex App updates.

View original on GitHub ↗