Add usage-limit rings to the /pet avatar overlay or expose a decoration hook
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%andweekly 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.