Skip to content
bvisiblePublic

About

Use several Claude accounts on one Mac, with one workspace. Switch Claude Desktop and Claude Code between work and personal accounts in one click: every conversation, pin and folder stays. See each account's limits. No credential touched.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

74 Commits

Folders and files

Repository files navigation

Relais, a Claude account switcher for Mac: the menu bar panel lists four Claude accounts with their 5-hour and weekly usage limits

Relais: several Claude accounts on one Mac, one workspace

Relais is a free, open-source Claude account switcher for macOS. A work account, a personal subscription, a client's organization: one click moves Claude Desktop and Claude Code to the account you need, and Desktop comes back exactly as you left it: the same conversations, pins, folders and settings. Relais shows each account's usage limits at a glance, and never reads a password, a token or a cookie.

MIT license Platform: macOS Built with Rust and Tauri Download the latest Relais release Relais website

Demo: Relais suggests the best Claude account to go to, asks for confirmation, then switches Claude Desktop to it

Why Relais

If you use more than one Claude account on the same Mac (Claude Pro, Claude Max, a work account), changing account normally costs you your place. Claude Desktop files its conversation list, pins and folders under the signed-in account, so signing in to another one shows you a different workspace.

Relais keeps one workspace and changes only the sign-in:

  • Everything stays. Conversations, pinned items, folder order, sidebar sections, permissions and session presets follow you to the next account.
  • You see every limit at a glance. Each account shows its 5-hour and weekly usage as rings, and when it comes back if it is paused. Plans without the 5-hour limit show the week alone.
  • It tells you where to go. At your current pace, the account that will last the longest is marked, counting those whose week starts over before they run out. Relais suggests, you decide: it never switches on its own.
  • Your credentials stay yours. Relais never reads, copies or stores a token, a cookie or a password.

What else it does

  • Alerts before the limit. A notification at 85% and 95% of a limit names the best account to go to, and its button opens the confirmation. Another tells you when a paused account is back.
  • Forecast. At the current pace, the panel says when the account in use reaches its limit.
  • Usage resets. When you reset a limit on claude.ai, Relais notes it and the account is no longer shown as paused. It shows the resets an account has left, Fable ones included, when Claude Code has learned them.
  • Resume what a switch stopped. The sessions a switch interrupted are listed afterwards, one click from running again.
  • Switch when it's done. With sessions running, Relais can wait, tell you when they finish, and ask again.
  • Where the week went. See which projects consumed the most this week, in the panel or with relais projects.
  • Your artifacts follow you. Every artifact Claude publishes is copied to ~/.relais/artifacts with its link and its account, so Claude finds it again from another account and publishes it once more instead of rebuilding it. Share an artifact once with your other addresses, with “Can edit”, to keep the very same link.
  • One account per folder. relais folder set work ~/Projects/client makes Claude Code always start there on that account.
  • A widget and a shortcut. Put your limits on the desktop, and open the panel from anywhere with Control-Option-R.
  • Updates in one click. Relais tells you when a new version is out and installs it when you say so.
  • Careful with Claude Desktop updates. Relais checks the workspace before anything moves, refuses what it does not recognize, and warns you about a newer major version.

Screenshots

Relais simple view: every Claude account on one line with its usage rings and a Switch here button
Simple view. Every account on one line, one button to switch.
Relais full view: where each Claude account works, its limits, and its usage day by day
Full view. One switch away: where each account works, its limits and its week day by day.
Relais confirmation before switching Claude accounts: what happens, which sessions are running, what stays
A switch is always confirmed. You see what happens, which sessions are still working and what stays.
Relais in dark mode on macOS
Follows your Mac. Light and dark, in English and in French.

How a switch works

flowchart LR
  A[You click Switch here] --> B[Claude Desktop closes]
  B --> C[The account's sign-in is set aside]
  C --> D[The next account's sign-in comes back]
  D --> E[Lists and settings follow]
  E --> F[Claude Desktop reopens]
Loading

Claude Desktop: one workspace, the sign-in changes. Desktop's data folder holds your whole workspace, and only four files in it make it signed in as one account. With Desktop closed, Relais renames those files aside, puts the next account's back, and carries to it what Desktop files under an account's id. Each step is journaled and backed up first: a step that fails undoes the switch at once, and a switch cut short is undone by the next run.

Claude Code in the terminal: one profile per account. Each account has its own CLAUDE_CONFIG_DIR. Transcripts, settings, skills and MCP servers are shared between profiles, and the parts of .claude.json not tied to an account stay in sync. New terminals follow the switch, and open ones keep their account.

More detail in the design document.

Your credentials stay with Anthropic

Relais does not read, copy, refresh or store any OAuth token, session cookie or Keychain secret. You sign in through Anthropic's own apps, they keep and refresh their logins as usual, and Relais only moves Desktop's sign-in files aside and back by renaming them, without opening them. That removes the whole class of "dead token" bugs that tools copying tokens have to chase.

Relais makes no call to Anthropic either: the only request it makes itself is to GitHub, for new versions. Usage comes from what Claude Code hands to its status line, from the history the desktop app keeps, from the figures Claude Code keeps in its own config after fetching them, and from Claude Code's own /usage panel: every quarter of an hour the app opens the official client in a private terminal, with nothing of yours loaded, reads the panel and closes it. No prompt is sent, nothing is billed and no conversation is saved.

Install

Download Relais for Mac, open the DMG and drag Relais to Applications, or use Homebrew:

brew tap bvisible/tap
brew install --cask relais

It needs macOS 13 or later, and runs on Apple Silicon and Intel. It is tested on macOS 26 and 27 on Apple Silicon, and its command and test suite also run on an Intel Mac in CI. The widget needs macOS 14. The app is signed with a Developer ID and notarized by Apple, so macOS opens it without a warning, and it offers new versions by itself.

Link the command that comes with the app and register the account you are signed in with:

mkdir -p ~/.local/bin
ln -s /Applications/Relais.app/Contents/MacOS/relais ~/.local/bin/relais
relais init

Add your other accounts, each signing in through Anthropic's own flow:

relais account add me@work.example  # signs in in its own Chrome profile
relais statusline-install           # record usage, and which account runs each session
relais shell-install                # make `claude` run with the active account
relais artifacts-install            # keep every artifact Claude publishes

If the panel says measuring waits for your OK, click Allow: Claude Code asks its first-run questions once, and Relais never answers them for you.

Build from source

You need Rust, Node.js, pnpm and Xcode's command line tools.

git clone https://github.com/bvisible/relais.git
cd relais
pnpm --dir app install
./app/scripts/build-macos.sh
cp -R target/release/bundle/macos/Relais.app /Applications/

Commands

The menu bar app and the relais command do the same work.

relais list                     # every account, its usage and how long until each reset
relais desktop work --dry-run   # what switching Claude Desktop to work would do
relais desktop work             # do it: Desktop closes, reopens on work, new terminals follow
relais desktop --bring-back     # Desktop closed: put back the conversations a switch set aside
relais switch next              # move only the terminal: a name, next, prev or best
relais continue                 # carry the latest conversation over to the active account
relais allow-measure            # answer, once, what Claude Code asks before Relais can measure
relais projects                 # what each project consumed this week
relais artifacts                # the artifacts kept on this Mac, with their account and link
relais artifacts path "<title>" # the page of an artifact's latest copy
relais folder set work          # this folder always starts on work; `relais folder` lists them
relais doctor                   # check sign-ins, links and integrations

FAQ

How do I switch between Claude accounts on a Mac?

Open the Relais panel in the menu bar and click Switch here next to the account you want. Claude Desktop closes and reopens on that account, and new terminals follow. From the terminal, relais desktop <account> does the same.

Can I use several Claude subscriptions on the same Mac?

Yes. Each account signs in once through Anthropic's own flow, and Relais keeps track of which one Claude Desktop and your terminals use.

Will I lose my conversations when I change Claude account?

No. Your local Claude Code and Cowork sessions, pins and folders stay in the same workspace. If the arriving account has conversations of its own, Relais asks whether to add them to your list or set them aside, and relais desktop --bring-back returns what was set aside. The Chat tab and cloud sessions live on Anthropic's servers under each account, so they do not move.

Does Relais see my Claude password or token?

No. It never opens them. The only thing it reads from a sign-in file is the account's id, which is not a secret, to know whose sign-in it is.

How does Relais know how much of my Claude limit is left?

It reads the figures Claude Code already gives its status line, the history Claude Desktop keeps, and the official /usage panel every quarter of an hour. A reading that stops updating says how old it is, and the advice ignores it once it is too old to go by.

Does it switch accounts by itself?

No. A ring turns orange as an account fills up and Relais marks the best one to go to, but the switch is yours.

Can Relais switch accounts without closing Claude Desktop?

No. Desktop has to restart on the other sign-in, so sessions working inside it stop, and the confirmation tells you how many. Sessions in terminals you already opened keep running on their account.

Which Claude plans does it work with?

It is developed and used daily on Claude Max accounts, with or without the 5-hour limit. A real switch was last checked on Claude Desktop 3.6556 with Claude Code 2.1.314. Other plans should behave the same: please open an issue if yours does not. A Claude update can change what Relais relies on, so it checks the workspace first and warns you about a newer major version.

What happens to my artifacts when I change account?

An artifact belongs to the account that published it, and Claude writes its page to a temporary folder. With relais artifacts-install (or Keep artifacts in the settings), Relais copies every published artifact to ~/.relais/artifacts, notes its link and account, and installs a skill that tells Claude to look there first. When the account in use cannot change an artifact, Claude publishes its copy as a new one, and Relais records that the new link follows the old one. To keep the same link, share the artifact once with your other accounts' addresses with “Can edit”. Comments and the page's stored data stay on claude.ai.

Does Relais work on Windows or Linux?

Not for now. Relais lives in the macOS menu bar.

Does Relais update itself?

It tells you when a new version is out and installs it when you click. Each update is checked against a key built into the app.

Is the Relais app signed and notarized?

Yes. Each release is signed with a Developer ID and notarized by Apple, and its SHA-256 sum is published next to the download.

What about Claude in Chrome?

It is out of scope: its sign-in lives in the browser.

Is Relais made by Anthropic?

No. Relais is an independent project, not affiliated with or endorsed by Anthropic. You remain responsible for using your subscriptions within Anthropic's terms.

Status

Relais is in early development, used daily on one Mac, where a real switch between two accounts kept every conversation, pin and folder. Issues and ideas are welcome.

Part State
Account registry, shared config sync, usage readings, conversation index done, tested
Terminal: relais command done, tested, in daily use
Claude Desktop switch that keeps the workspace done, tested, used for real
Menu bar app (Tauri, React) with a simple and a full view done, tested

To work on it, see app/ and crates/. cargo test and pnpm --dir app test run everything, on made-up accounts. The images above come from app/scripts/capture.mjs, which only ever shows made-up accounts too.

License

MIT, by Neoservice AI. Claude and Claude Code are trademarks of Anthropic.

About

Use several Claude accounts on one Mac, with one workspace. Switch Claude Desktop and Claude Code between work and personal accounts in one click: every conversation, pin and folder stays. See each account's limits. No credential touched.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages