config.toml.example

# multi-provider-usage-widget configuration — copy to ~/.config/multi-provider-usage-widget/config.toml and edit.
# Every field is optional; omitted fields use the defaults shown here.

# Redraw cadence in milliseconds (countdowns/age tick at this rate; no network).
ui_tick_ms = 1000

[refresh]
# Master switch for automatic OAuth token refresh + write-back to the native
# credential files (~/.claude/.credentials.json, ~/.codex/auth.json,
# ~/.grok/auth.json). When the widget refreshes a token it writes the rotated
# token back so your real CLIs stay in sync.
auto_refresh_tokens = true
# Treat a token as expired this many seconds before its real expiry.
expiry_skew_secs = 60
# Take an advisory file lock around the read-refresh-write critical section.
use_file_lock = true
# On a 401, re-read the credential file and retry once before giving up.
tolerate_401 = true

[thresholds]
# Usage-bar colour: green below `warn`, yellow below `crit`, red at/above.
warn = 60.0
crit = 85.0

[claude]
enabled = true
# The usage endpoint is aggressively rate-limited; the floor is 300s and any
# smaller value is clamped up to 300.
interval_secs = 300

[codex]
enabled = true
interval_secs = 300
# Prefer the live wham/usage endpoint; fall back to the newest on-disk session
# snapshot if false or if the live call fails.
prefer_live = true
rollout_glob = "~/.codex/sessions/**/rollout-*.jsonl"

[grok]
enabled = true
# Reads monthly credits used (%) + reset date from the billing endpoint — the
# same data `grok` -> /usage show displays. It's a plain authenticated GET and
# does NOT consume any query allowance, so it auto-polls like the others.
interval_secs = 300