Switch active account
Use Activate in Settings > Accounts to select a preferred account. When you have more than one Claude account configured, Omniscio's account pool picks an account for each new session at spawn time. The session header shows a small indicator with the active account's email and a colored capacity dot, so you can always see who is powering the running session, but there is no per-session account dropdown to change mid-conversation.
On this page
What it is
Use Activate in Settings > Accounts to select a preferred account. When you have more than one Claude account configured, Omniscio's account pool picks an account for each new session at spawn time. The session header shows a small indicator with the active account's email and a colored capacity dot, so you can always see who is powering the running session, but there is no per-session account dropdown to change mid-conversation.
Read this first — which mode you are in changes what "active account" means. Load balancing (
distributeSessionsAcrossAccounts) is OFF by default (since 2026-08-29 — fresh installs run a single account; installs from before that date keep the on-by-default setting they had), so the pin-first behaviour this page's steps describe IS the default. When you turn load balancing ON, it deliberately spreads new sessions across your accounts instead of preferring the active one — "Activate" then does not pin every spawn; it sets the display default and moves your existing sessions, and new spawns are still spread. Both modes are covered below, and the mechanics live in distribute-sessions-across-accounts.md.
With load balancing off, the active account (the one you've "Activated" or that Omniscio defaulted to) acts as a soft preference — the pool uses it first if it has capacity, then transparently falls through to other accounts if it doesn't, scoring the rest by remaining 5-hour and 7-day capacity.
This is intentional. Mid-turn switching would invalidate the CLI's auth context, and the pool handles 95% of the "I'm running low" cases without the user having to think — by spreading across accounts under load balancing, or, with it off, by walking the tier list (pinned → primary capacity → extra credits → API key). The two places "switching" actually happens in the UI are: (1) clicking Activate next to an account row in Settings → Accounts, which sets the preferred-account flag; and (2) the silent automatic switch the pool does at the next spawn — covered in account-pool.md.
Where to find it
Settings → Accounts — each account row carries an Activate link. The session header shows which account is powering a running session.
How it behaves
How to use it
Default behavior — do nothing. When you start a new session the pool picks for you, and the session header shows that account's email.
- Load balancing ON: the picker (
pickViaLoadBalancer) deliberately ignores the pinned account and spreads the session onto whichever account is least loaded, scoring bymax(5h,7d)plus live-session and in-flight penalties minus a soon-to-reset bias. - Load balancing OFF (the default): the pool reads cached usage data, scores each login account by
max(5h_utilization, 7d_utilization), and uses the lowest-utilization one — but keeps using your active (preferred) account first while it still has capacity.
- Load balancing ON: the picker (
Pin a preferred account. Open Settings → Accounts. Each account row has an Activate link unless it's already the active one (green dot,
bg-accent/10highlight). Click Activate to pin it. There's no separate "Pin" toggle — Activate is how you pin. What pinning actually buys you depends on the mode:- Load balancing ON: Activate does not pin future spawns. It moves your EXISTING sessions (that is treated as deliberate user intent) and becomes the display default, but new sessions keep being spread. To get "everything on one account" back, turn load balancing off in Settings → Accounts.
- Load balancing OFF (the default): the pool prefers this account on every spawn, falling through only when it hits its caps.
Read the session header indicator. The toolbar shows a small
AccountIndicator(CircleUser icon plus a percent capacity dot). Click it to see the active account's email, plan tier, and 5-hour / 7-day usage bars; the popover also lists every other account so you can see at a glance who else is in the pool. When the active account changes — whether you clicked Activate yourself or the silent rate-limit auto-switch picked a different one — the pill plays a brief 700 ms left-to-right shimmer flash so you notice the swap without it feeling intrusive. The same flash plays on the mobile chip in the tab bar. The animation is suppressed underprefers-reduced-motion.What happens mid-turn. Once a session has spawned, Omniscio does not swap the account out from under it for the rest of that turn — the spawned CLI process holds the active account's credentials in env vars and runs to completion. The pool re-evaluates only at the next spawn (a brand-new session, or a Continue after rate-limit recovery). A rate-limited session that recovers can transparently resume on a different account; the system message reads "resuming on current account" or "switching to <email>" depending on which path the recovery service took (see session-stuck-in-needs-you.md "Rate Limited" case). When the move has to rebuild the conversation instead of resuming the CLI's own transcript, that rebuild is capped to a request-sized slice of the history (400 000 characters) rather than the engine's whole window, so a very long session comes back with its recent work instead of a prompt the engine cannot ingest.
Force a specific account for one session (advanced). Turn load balancing off first — with it on, the picker ignores the pin and the trick below does nothing. Then: pin that account via Activate before clicking New Session, let the spawn happen, and re-pin your usual account afterwards. There is no "lock this session to account X" affordance —
account_idis recorded on the session row at spawn but is overwritten by the pool's choice on every restart, so it isn't a hard binding.Auto-switch on rate limit (related setting). Settings → Accounts also has an Auto-Switch Account on Rate Limit toggle (visible only when you have 2+ accounts; default on). On a default install this toggle is inert — while load balancing is on,
onSessionRateLimitedhands off to the LB-aware path before the global auto-switch is ever reached, so the automated whole-account switch is suppressed (the two would otherwise fight). What actually happens at a cap is the LB per-session recovery: only the capped session moves, onto an account that excludes the one that just capped, and your active account is left alone.- With load balancing OFF, the toggle behaves as written: when a session hits a 5-hour cap, the recovery service silently switches your whole active account to another with capacity and continues; toggling it off makes the session sit idle until the timer resets.
- The manual Activate switch is unaffected in either mode.
Auto-switch on login expiry (2026-07-03). Rate limits aren't the only thing that moves a session to another account — a login expiring does too. If a session's Claude login goes stale and its silent auto-retries can't refresh it, Omniscio now hands the session to another account whose login is healthy and keeps it running, instead of dead-ending on "Please re-authenticate." It happens silently; the expired account keeps a "sign in again" badge in Settings → Accounts so you can fix it whenever. You only see the re-authenticate prompt when there's genuinely nothing to switch to — a single account, or every login expired. (Unlike rate-limit auto-switch, this isn't tied to the "Auto-Switch on Rate Limit" toggle — a dead login has no "wait for reset" alternative, so switching is always the right move when a healthy account exists.)
Related
- account-pool.md — the authoritative explanation of the tier-list and how the pool actually chooses
- add-a-claude-account.md — adding the second (or third, or fourth) account that makes switching meaningful
- remove-a-claude-account.md — taking an account out, including what happens to its in-flight sessions
- session-stuck-in-needs-you.md — the "Rate Limited" case where a silent cross-account resume kicks in
- usage-forecast.md — the inline projection that tells you when the active account will run out, so you know whether to pin a different one
Last verified 2026-09-23