Auto-roll guardrails: avoid Codex 429s automatically

Auto-roll in CodexUse moves your work to a fresher account before Codex stalls on a 429. Set Roll below, Rejoin above, and Warn below once, and the app handles the move, complete with a confirm countdown that cancels any stale decision. Every threshold is a percentage of quota left, never a percentage used.

What Auto-roll does

• Watches the headroom of your active account in real time.
• Notifies you when the active account drops below Warn below.
• Rolls to the next eligible account in your priority order when the active one drops below Roll below.
• Shows a confirm countdown before it acts, so a stale roll can be cancelled instead of firing blind.
• Keeps a log of recent rolls so you can see what it did and why.
• Stays fully local. No external scripts run and nothing is reported to the cloud.

Turn it on in four steps

1. Open CodexUse on a Mac (2.0.0 or newer on Apple Silicon). Auto-roll controls official Codex app windows, so it is a macOS feature.
2. Open the Accounts tab.
3. Turn on Auto-roll. It ships off and shows the current Roll below percentage once it is on.
4. Set Roll below, Rejoin above, and Warn below 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 thresholds are a percentage of quota left. A lower number means Auto-roll acts later, with less headroom to spare.

• The app keeps Rejoin above higher than Roll below, so an account cannot rejoin the queue at the same level that pushed it out.
• On a single account, keep the defaults. Raise Roll below only if you want to roll earlier, while more quota is still left.

Refill timers and outside windows

• Start refill timers automatically: after Auto-roll leaves an exhausted account, attempt a short background Codex request. OpenAI controls the refill time.
• Take over outside windows: lets Auto-roll restart a Codex window that CodexUse did not open. Restarting that window loses unsaved work in it, so this is off unless you turn it on.

How CodexUse picks the next account

• Auto-roll walks your accounts in the priority order you set, uses only accounts marked Include in auto-roll, and skips any that show Needs sign-in.
• If two accounts share one OpenAI identity, you'll see the duplicate warning. The app still rolls, but the rate limit is shared, so the headroom you gain is smaller.
• Accounts 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. Nothing is deleted.
• Keep CodexUse open or in the menu bar. Fully quitting stops the refresher.
• Check that your accounts show Ready. An account that shows Needs sign-in is skipped until you refresh it.

Guardrails already working alongside it

• Headroom shows the percent left in each usage window for every account, and how long until it refills.
• Each account has its own Codex window, so you always know which account is live.
• The update prompt lets you restart on your terms, keeping the rate-limit probes current.

Related