| summary |
Refresh cadence, background updates, and error handling. |
| read_when |
Changing refresh cadence, background tasks, or refresh triggers |
Investigating refresh timing or stale data behavior |
|
RefreshFrequency: Manual, 1m, 2m, 5m (default), 15m, 30m.- Stored in
UserDefaults via SettingsStore.
- Background refresh runs off-main and updates
UsageStore (usage + credits + optional web scrape).
- Manual “Refresh now” always available in the menu.
- Stale/error states dim the icon and surface status in-menu.
- Optional provider-storage scans run only when “Show provider storage usage” is enabled. They are scheduled in the
background, coalesced/throttled during automatic refreshes, and forced by manual refresh without blocking the usage
refresh path.
- Auto-seed a log if none exists via
codex exec --skip-git-repo-check --json "ping" (currently not executed).
See also: docs/status.md, docs/ui.md.