Using Smart Router

Smart Router keeps your agents working when an account runs out. You line up your accounts in a router, and Moxie watches the one in use. When it reaches its limit, new requests move to the next account in the chain, before the old one hits 100%. When an earlier account’s limit resets, Moxie moves back to it.

Before you start#

• Moxie is running and the proxy is on.
• You have at least two accounts in Accounts. They can be from different providers: a Claude account can hand over to Codex, Gemini, or an API key.

Make a router#

1. Open Smart Router in Moxie’s sidebar.
2. Click New router.
3. Give it a name.
4. Add the accounts you want, in the order you want them used. Use Add account for more, and the ··· menu next to an account to Move up, Move down, or Remove it.
5. Click Save.

Each account shows how it signs in (OAuth or API key), so you can tell your subscriptions from pay-as-you-go keys at a glance.

Choose the models for each account#

By default, each account in a router uses its own models, the ones you set for it on Home. To use different ones while Smart Router has that account in place:

1. In the router’s editor, click Own models next to the account.
2. Choose a model for each slot.
3. Click Done, then Save.

The account now shows Custom models. Its own models on Home stay as they are, and Moxie goes back to them when you pick the account yourself. To undo it, open the slot editor again and click Use its own models. See Using Slots for what each slot is for.

Turn it on#

On the Smart Router page, choose your router in the Router menu, or choose Turn on from the router’s ··· menu. Choose Off to stop routing.

While a router is on, Home shows a Smart Router card above the account picker: what it’s doing and which account is next. Click View to open the Smart Router page.

Settings#

Both are on the Smart Router page:

• Switch at: how full an account gets before Smart Router moves on. It’s 97% by default, and counts every usage limit the account has, such as its 5-hour and weekly limits. If you run many agents at once, choose a lower number: replies already in progress finish on the old account, and they need some room to finish in.
• Use credits as a last resort: when every account in the chain is at its limit, Smart Router moves to one that still has Codex credits or Claude extra usage. Credits are billed. It’s on by default.

Watch it route#

The top of the Smart Router page shows your router live. Claude Code sits at the top, with a line to the account serving its requests, and dots run along the line while requests are in flight. Below it is each account in the chain with its usage limits, the switch mark on each bar, and how Smart Router sees it right now:

Shown	What it means
Serving	New requests go to this account.
Next	The account Smart Router moves to if the serving one runs out.
Ready	Has room to take over.
Near limit	Past your switch point, but still working.
At limit	The provider is turning requests away. It shows when the limit resets.
Credits left	At its limit, but has credits it can keep working on.
Sign-in needed	The account’s sign-in stopped working. Sign in again in Accounts.
Skipped	Deactivated, archived, without credentials, or not covered by your trial.

API key accounts don’t report usage, so they show no limits. Smart Router treats them as ready unless the provider turns a request away.

How Smart Router behaves#

• It moves before the limit. New requests go to the next account as soon as the current one reaches your switch point, or right away if the provider starts turning requests away.
• It picks the best account, not just the next one. An account with room left comes first, earliest in the chain. Accounts with credits come only after every account is past its switch point.
• It moves back when it can. Once an earlier account’s limit resets and it has some room again, new requests move back to it after a short pause.
• Your pick wins. Choose an account yourself on Home, in Accounts, or in the menu bar, and Smart Router leaves it alone until it runs out. If it isn’t in the chain, Smart Router then moves onto the chain.
• It never interrupts a reply. A reply that’s already being written finishes on the account it started on.
• It tells you. A notification says each time it switches, and when every account in the chain is at its limit. Turn these off with Limit notifications, under Settings › Notifications.
• When everything is at its limit, Moxie stays on the current account and moves the moment any account in the chain has room again.
• Routers are part of your backups, under Settings › Backup & Restore.

Edit, copy, or delete a router#

Each router has a ··· menu:

• Edit… changes its name, accounts, and models.
• Duplicate makes a copy you can change.
• Delete… removes it. If it was on, Smart Router turns off.

Troubleshooting#

Smart Router doesn’t switch. Check that the router is on and that the proxy is running: the Smart Router page says “Off” otherwise. Check that the accounts after the serving one show Ready in the live view.

An account is shown as Skipped. Turn it back on in Accounts, or add its credentials. During the free trial, only the first two accounts can be used.

An account shows “No usage data yet.” Moxie hasn’t checked it yet. It checks every account in the background, and Smart Router checks the next one itself as the serving account nears its limit.

Credits aren’t used. Check that Use credits as a last resort is on. Claude extra usage is only visible for Claude accounts imported from the Claude CLI.

Still stuck? Email [email protected] with your Moxie version and what the Smart Router page shows.