A menu bar app for macOS that keeps all your Claude and Codex accounts one click away — and shows how much quota each one has left.
English · 简体中文
Screenshots use demo data.
- One-click account switching for Claude Code and Codex. New sessions pick up the new account immediately.
- Live quota for every account — the 5-hour and weekly windows, with the remaining percentage and the reset time.
- Menu bar gauge — a double ring shows the active account's 5-hour (outer) and weekly (inner) quota at a glance.
- Switch suggestions / auto-switch — when the active account is nearly out of quota, or another account has weekly quota about to expire unused, SwitchBoard suggests (popup) or performs a switch by priority. Off by default.
- Local token usage — a Usage page (footer) totals the tokens read from your local Claude / Codex session logs: today or the last 7 days, cache hit rate, input / output / cache read / cache write / reasoning, and a per-model list with estimated cost (Claude) and generation speed (Claude).
- Claude Desktop sync — optionally switch the Claude desktop app to the same account.
- Add accounts in place — save your current login, or sign in to another account without touching the one you're using.
- Cached quota — the last known numbers show instantly on launch; refreshes run one account at a time.
- Auto-update — an Update button appears in the panel when a new release is out. One click and it restarts on the new version.
- English & 简体中文 UI — follows your system language, or pick one in the ⋯ menu.
- Launch at login, dark UI that follows the active provider's accent colour.
- Download the latest
SwitchBoard-x.y.z.dmgfrom the Releases page. - Open it and drag SwitchBoard into Applications.
- Launch it — a gauge icon appears in the menu bar.
The app is ad-hoc signed, not notarized. If macOS says it can't verify the developer, right-click the app → Open (once).
Requires macOS 14 or later.
- Log in to Claude Code / Codex as you normally do, then click the menu bar icon. SwitchBoard offers to add the current account.
- To add more accounts, press Log in to another account and finish the browser login.
- Click any account card to switch to it. Restart already-open IDEs / Codex sessions to pick up the change.
- Use the provider switcher at the top-left of the panel to flip between Claude and Codex.
- The ⋯ menu has launch-at-login, Claude Desktop sync, Check for updates and Quit.
Codex note: SwitchBoard reads
~/.codex/auth.json. If your Codex stores credentials only in the keychain, setcli_auth_credentials_store = "file"in~/.codex/config.tomland log in again.
Pick a mode in ⋯ → Account switching → Mode: Off (default), Suggest (a small popup under the menu bar icon shows the current and the suggested account's quota and reset times, and you confirm), or Auto-switch (switches right away and sends a notification). Claude and Codex are evaluated separately; nothing happens while a custom API / relay account is active.
When it switches
- Quota nearly used up — the active account's 5-hour or weekly quota drops to the Switch away below value (default 5%), or at the pace you're currently using it the 5-hour quota will run out within ~20 minutes — and another account that is usable right now has clearly more. If the 5-hour quota will last until it resets at the current pace, it waits instead (without speed data: waits if the reset is within 15 minutes).
- Weekly quota about to expire — another account has unused weekly quota that is about to reset, and its "expiring" part reaches Switch to expiring quota ≥ (default 25%), so it is used first. If the active account has expiring quota too, it only switches when the target's weekly quota expires earlier — so it never ping-pongs.
Expiring quota = how much weekly quota is predicted to be left when it resets. SwitchBoard samples every account's weekly quota (kept for 72 hours), estimates your overall usage speed over the last hour, day and 72 hours (weighted 25% / 55% / 20%, favoring recent usage; a window with too little data is skipped), then simulates "earliest weekly reset is used first" to see what each account will have left. Plans differ in capacity (Pro, Max 5x, Max 20x) and are weighted accordingly — 1% of Max 20x weekly ≈ 10% of Pro. If all three windows lack data it falls back to assuming even consumption: weekly remaining % − (share of the weekly window left × 100).
How accounts are ranked: accounts that are usable now come first (at your active pace the 5-hour quota lasts at least an hour; without speed data: ≥ 30% available); then those whose expiring quota meets the threshold, earliest weekly reset first; the rest by 2 × expiring + 0.5 × available. Windows that reset within 60 minutes are ranked as if already reset (100%), but it only switches once the account is actually usable.
At least 10 minutes between switches; Dismiss mutes the same account and reason for 1 hour. Checks run after every quota refresh.
A switch affects new sessions only — restart open ones. After switching accounts, old sessions may show a "Claude can't use thinking from another organization" notice; it only costs some extra tokens.
Not-enough-quota warning: SwitchBoard projects the next 7 days at your recent usage pace (each account's weekly quota refills at its reset, earliest reset used first). If there would be a stretch where every account's weekly quota is exhausted, a small Quota short badge appears in the header; hover or click it to see roughly when that happens and how many hours over the next 7 days nothing is available — a hint to add an account or upgrade a plan. It needs at least a day of usage data before it shows, so a short burst isn't mistaken for your normal pace.
Click Usage in the panel footer. The page follows the provider switcher (Claude / Codex) and shows Today or 7 days: total tokens, cache hit rate, input / output / cache read / cache write / reasoning tokens, and a per-model breakdown.
- Where the numbers come from — SwitchBoard reads the session logs already on your machine (
~/.claude/projects,~/.codex/sessions). Nothing is uploaded. Chats in the Claude web or desktop app are not in those logs, so they aren't counted. - Scanning — the first launch reads the last 7 days (about 10 s for a few GB of logs); after that only newly appended lines are read, and the counts are kept per hour in
tokens.json. - Cost — an estimate at API prices (cache read 0.1×, cache write 1.25× / 2×), shown only for Claude models with known prices. It is not what you pay on a subscription.
- Speed (tok/s) — Claude only: output tokens divided by the streaming time after the first content block, so first-token latency is excluded. It is an estimate; messages without a thinking block first are skipped.
- Used for forecasts — SwitchBoard also records which account was active over time. Once an account's weekly window lies fully inside that record, its used quota is matched against the cost in the logs to estimate how much quota a dollar of usage consumes. That estimate replaces the quota-sample-based usage speed for Claude, and falls back to the samples while there is not enough data.
- Account credentials are stored in a single macOS Keychain item (
SwitchBoard/vault). Account metadata and the quota cache live in~/Library/Application Support/SwitchBoard/(the cache holds percentages and reset times only). - Switching an account writes that account's login into the place the CLI already reads (
~/.claude.json/~/.codex/auth.json) and takes care of rotating refresh tokens. - Quota is fetched from the same endpoints the official CLIs use for
/usage. No third-party servers are involved; the only other network call is checking GitHub Releases for updates. - Nothing is uploaded anywhere.
Needs Xcode (the SwiftUI macros require the full toolchain).
git clone https://github.com/chenbstack/switchboard.git
cd switchboard
./build.sh # → build/SwitchBoard.app
open build/SwitchBoard.appHandy flags for development:
build/SwitchBoard.app/Contents/MacOS/SwitchBoard --demo --show # fake data, open the panel on launch
build/SwitchBoard.app/Contents/MacOS/SwitchBoard --demo --snapshot out.png # render the panel to a PNGReleases are built by GitHub Actions: pushing a v* tag builds the app, packages a .dmg (for installing) and a .zip (used by the in-app updater), and publishes them as a GitHub Release.
SwitchBoard is an independent tool and is not affiliated with Anthropic or OpenAI. Claude and Codex are trademarks of their respective owners. Use it with accounts you own and in line with each provider's terms.