---

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

---

Refresh loop

Cadence

• RefreshFrequency: Manual, 1m, 2m, 5m (default), 15m, 30m.
• Stored in UserDefaults via SettingsStore.

Behavior

• 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 future

• 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.