Auto-roll guardrails: avoid Codex 429s automatically
CodexUse Pro can switch to a fresher profile before you hit rate limits. Set your warning and switch thresholds once, keep the app running in the tray, and let auto-roll handle the swap.
What auto-roll does
- Listens to the rate-limit radar (Pro) for your active profile.
- Warns when usage crosses your warning percent.
- Switches to the next available profile when the switch percent is reached.
- Stays local. No analytics or external scripts run during this.
Heads up: Auto-roll needs CodexUse Pro and at least two valid profiles. Keep
the app running (tray is fine) so the refresher can see usage.
Turn it on
- Open CodexUse on macOS 13+ or Linux ARM64 (0.8.0 or newer).
- Click the Settings gear in the top bar.
- Open the Auto-roll tab.
- Toggle Enable auto-roll.
- Set a Warning threshold (default 85%) and Switch threshold (default 95%).
- Close Settings. You can keep the window closed after this; the tray keeps running.
Pick thresholds that match your limits
- Stay within 50-100%. The app enforces the range and keeps the switch above the warning.
- Team workspaces often pool limits. If you share a workspace, pick a lower warning (for example 75%) to notice early.
- Solo accounts can keep the defaults. Switch only when you are close to the top to avoid needless flips.
How CodexUse decides which profile to use
- Auto-roll uses the saved profile list. It respects profiles marked valid and skips ones needing login.
- If multiple profiles share the same Codex account ID, you will see the duplicate warning. The app still rotates but rate limits will be shared, so the benefit is smaller.
- Profiles stay local and re-use the bundled Codex CLI tokens. No extra browser loops are triggered.
If auto-roll pauses
- Confirm you are on Pro. Rate-limit radar and auto-roll do not run on the free tier.
- Make sure CodexUse is open or sitting in the tray. Fully quitting stops the refresher.
- Check that your profiles are valid. If a profile needs login, the switch is skipped until you re-auth.
Related safeguards already in the app
- Rate-limit radar cards show usage percent and reset windows per profile.
- Tray menu reflects the active profile so you always know which account is live.
- Update prompt restarts the app after a short grace window so the rate-limit probes stay current.
Does auto-roll change my config files?
No. It switches the active Codex profile using the same files the CLI uses. It does not rewrite your config.toml.
Can I keep auto-roll off but still see the radar?
Yes. Leave auto-roll disabled and use the rate-limit cards to decide manually. The radar is part of Pro; the toggle only controls automatic switching.
Does this work on Windows?
Today CodexUse ships for macOS Apple Silicon and Linux ARM64. Windows is in progress; auto-roll will land there when the build is available.