Tray Usage

August 17, 2026 ยท View on GitHub

This optional feature shows the same rate-limit windows already used by the profile menu in the Linux system-tray menu. It does not make a second request or move account credentials into the Electron main process: the renderer's existing tray-menu-threads-changed message already carries compact usage labels, and this feature enables those labels in the Linux menu.

Enable it by copying linux-features/features.example.json to linux-features/features.json and adding the feature id:

{
  "enabled": [
    "tray-usage"
  ]
}

Then rerun ./install.sh or the native package build flow. Fully quit every ChatGPT Community process before launching the rebuilt app. Depending on the desktop shell, open the tray menu with the tray icon's context-menu click (usually right-click on Linux); a normal left click still opens the app.

The labels are read-only and can be absent while usage data is loading or when the account has no rate-limit windows. They refresh whenever the app's existing usage state refreshes. Multiple windows (for example, five-hour and weekly) are shown separately with their reset time when available.

Known risks

The patch targets a minified upstream Electron bundle and is intentionally optional. If the upstream tray-menu contract changes, the patch leaves the bundle unchanged and records optional drift rather than guessing at a new location.

Testing

node --test linux-features/tray-usage/test.js