Skip to content

About

Intelligent account routing for Claude Code

Resources

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

Switchboard's logo: one line in and three out, the one picked lit, in amber on black

Switchboard

Intelligent account routing for Claude Code.

Running Claude Code on more than one Claude account? Switchboard intelligently routes each new session to the best account, keeps it there while its cache is warm, moves it when a limit hits, and ring-fences client work to its own pool, all automatically.

Simply start claude as normal: nothing about how you work changes. Behind it, a live dashboard shows what every account has left and when it resets, Claude can read its own limits and pace its work around them, and every request is kept on record, with what it was worth.

License: MIT Go Platform: macOS

Docs · Pools · Commands · Configuration · Troubleshooting

A tour of the dashboard: the Overview as a new session arrives, the Log and the session page, Trends' burn-down cards and its year, Runway, Sessions with requests travelling their cords and its List of the week's sessions, Projects ranked by their worth, and Accounts

Why Switchboard?

Every Claude plan has a weekly limit, and many have a 5-hour limit too. When an account hits one, Claude Code stops. Changing accounts by hand means quitting and signing in again, and the session resumes on a cold cache.

  • Limits don't end your session. A request refused at a limit is replayed on another account before Claude Code sees the refusal. Limits and routing
  • Client work keeps its accounts. Fence a pool to ~/Code/acme, and only sessions started there use the accounts in that pool. Pools
  • Claude paces itself. Ask Claude to spend what's left before the 08:00 reset without reaching 100%, and it spreads the work to fit. Claude and switchboard
  • See when you'll run out. Runway, one of seven dashboard tabs, shows when each account runs out at your pace and when it has room again. Runway
  • Every request, priced. The record keeps 400 days of requests, and sets what they'd cost at API prices against what your plans cost. Your record
  • Resets arrive one at a time. Give switchboard your working day, and it starts the 5-hour window of each account at a different time. Staggered resets

Also: Notifications · Room for the Claude app · Pinning and moving · Backups and a new Mac

With one account, everything but the replay still works, because a replay needs a second account to move to.

Screens

The Overview: every account's usage, routing, sessions, COMING UP and LATELY
Overview
Where every account stands right now
Accounts' Compare: a column for each account and one for all of them
Accounts
How the accounts compare, side by side
Projects: each project's live sessions, sessions, worth and requests over this week, the chosen one in full under them
Projects
Where your use went, project by project
Sessions' List: this week's sessions, those running first, then those ended under a rule for each day
Sessions' List
Every session of the period, in one list
Trends' YEAR: a square a day over the last 12 months, BY MONTH under it
Trends' year
How your use has gone over the year
Sessions' Switchboard: each session corded to the account it runs on
Sessions
Which account each session is on
Runway over the week: a lane for each account, showing when it has room
Runway
When each account has room
Trends: a burn-down card for each account, its room over the week, and where it's heading
Trends
Where each week is heading, account by account
The Log's Requests: a line for each request the router routes
The Log
What the router did, request by request
The session page: its requests over time, its move between accounts, and its turns
The session page
One session, from start to exit
The theme picker open over the Overview
Themes
Nine built in, or your own
The Overview in a phone's terminal, 52 columns wide
On a phone
Every tab laid out for a narrow screen

Install

You need macOS, Claude Code, and one or more Claude accounts.

brew install leeovery/tools/switchboard

Or, with Go 1.27 or later:

go install github.com/leeovery/switchboard/cmd/switchboard@latest

To remove it, run switchboard uninstall, then brew uninstall switchboard. Your config, tokens and record stay for a reinstall unless you add --all. See Commands.

Quick start

# Add your accounts and install the rest
switchboard setup
# Start Claude Code, routed
claude
# See what every account has left
switchboard usage
# Open the live dashboard
switchboard dashboard

setup walks you through each step full screen, and makes the token for each account with claude setup-token as it goes.

Upgrading? Run brew upgrade switchboard. The router restarts into the new version by itself once no request is in flight. If it can't, see Troubleshooting.

Questions you may have

  • Does it read my conversations? No. It records each request without the content, and never edits a request body. Your record
  • What if switchboard stops? By default, claude says the router is down and doesn't start. Set when_router_down = "direct" to start without it. Configuration
  • Does moving a session cost me? A move starts on a cold cache, so a session stays on its account while the cache is warm. Limits and routing
  • Can I still use the Claude app? Yes. Give an account a reserve, and the router leaves that share of every window for you. Only a pin you set, or a session started without the router, spends it. Room for the Claude app
  • Is it macOS only? Yes, for now. How it works

Where next

Working on switchboard itself? Start with CONTRIBUTING.

License

MIT

About

Intelligent account routing for Claude Code

Resources

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages