28 lines (22 loc) · 1006 Bytes

summary

Menu bar UI, icon rendering, and menu layout details.

read_when

Changing menu layout, icon rendering, or UI copy

Updating menu card or provider-specific UI

UI & icon

Menu bar

LSUIElement app: no Dock icon; status item uses custom NSImage.
Merge Icons toggle combines providers into one status item with a switcher.

Icon rendering

18×18 template image.
Top bar = 5-hour window; bottom hairline = weekly window.
Fill represents percent remaining by default; “Show usage as used” flips to percent used.
Dimmed when last refresh failed; status overlays render incident indicators.

Menu card

Session + weekly rows with resets (relative countdown when available).
Codex-only: Credits + “Buy Credits…” in-card action.
Web-only rows (when OpenAI web enabled): code review remaining, usage breakdown submenu.

Widgets (high level)

Widget entries mirror the menu card; detailed pipeline in docs/widgets.md.

See also: docs/widgets.md.