Auto-roll guardrails: avoid Codex 429s automatically
Auto-roll in CodexUse Pro switches to a fresher profile before Codex stalls on a 429. Set the Switch line, Rejoin line, and Alert line once, and the app handles the swap, complete with a confirm countdown that cancels any stale decision. Every line is a percentage of quota left, never a percentage used.
What auto-roll does
- Watches the rate-limit radar for your active profile in real time.
- Notifies you when the active account drops to your Alert line.
- Hands the active account off to the next one in the queue when it drops to your Switch line.
- Shows a confirm countdown before it acts, so a stale switch can be cancelled instead of firing blind.
- Stays fully local. No external scripts run and nothing is reported to the cloud.
Turn it on in four steps
- Open CodexUse (2.0.0 or newer on Apple Silicon macOS).
- Open the Rotation tab.
- Arm auto-roll from the arm bar. It ships disarmed and reads Auto-roll is armed once it is on.
- Set the Switch line, Rejoin line, and Alert line with the increase and decrease controls. The window can stay closed if you turned on Keep running after close in Settings → Preferences.
Pick thresholds that match your limits
All three lines are a percentage of quota left. A lower number means auto-roll acts later, with less headroom to spare.
| Line | Default | Range | What it does |
|---|---|---|---|
| Switch line | 5% left | 1–50 | Hands the active account off to the next one in the queue when it drops to this much left. |
| Rejoin line | 15% left | 5–95 | An account that was held out rejoins the queue once it refills above this much left. |
| Alert line | 1% left | 1–50 | Notifies you when the active account drops to this much left. |
- The app keeps the Rejoin line above the Switch line, so an account cannot rejoin the queue at the same level that pushed it out.
- On a single account, keep the defaults. Raise the Switch line only if you want the handoff earlier, while more quota is still left.
How CodexUse picks the next profile
- Auto-roll walks your saved profile list, honors profiles marked valid, and skips any that need login.
- If two profiles share one Codex account ID, you'll see the duplicate warning. The app still rotates, but the rate limit is shared, so the headroom you gain is smaller.
- Profiles stay local and reuse the Codex CLI tokens already on your machine. No extra browser loops fire.
If auto-roll goes quiet
- Confirm you're on an active trial or Pro. Auto-roll locks after the trial without Pro.
- Keep CodexUse open or in the tray. Fully quitting stops the refresher.
- Check that your profiles are valid. A profile that needs login is skipped until you re-auth it.
Guardrails already working alongside it
- Rate-limit radar cards show usage percent and reset windows for every profile.
- The tray menu names the active profile, so you always know which account is live.
- The update prompt lets you restart on your terms, keeping the rate-limit probes 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 available during the trial; Pro keeps automatic switching unlocked after the trial.
Does this work on Windows?
Current public desktop releases target Apple Silicon macOS. For Linux or SSH workflows, use the optional CodexUse CLI.