Skip to content
surajmandalcellPublic

About

MacOS application to let you easily switch AI Sub accounts keeping your conversations intact, keeping your conversations intact.

Topics

Resources

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Repository files navigation

Switch app icon

Switch

Coding accounts and usage. Right in your menu bar.
Works with Codex, Claude Code, Droid, Gemini CLI, and more.

Download for Mac  ·  Website  ·  Installation  ·  Report a problem

Four tiles with a caption under each: Beautifully native, Limits at a glance, Also in the terminal, and Switches before you run out

Why Switch

Switch keeps your coding accounts in one place and shows how much each one has left.

  • Quick. Pick an account in the menu bar. Switch changes that tool's login for you.
  • Careful. It saves the old login and backs up what it replaces. Settings and local conversations stay.
  • Clear. See limits, reset times, and token use for every account.
  • Private. Hide email addresses or turn on Privacy mode. Switch does not read browser cookie stores.
  • Native. A small Mac app, plus a terminal app for macOS and Linux.

There is more: search local conversations, preview Cleanup before it moves anything to the trash, and back up chats and settings.

Installation

Mac (Apple silicon, macOS 14 or later)

Run this in Terminal:

curl -fsSL https://raw.githubusercontent.com/surajmandalcell/switch/master/install.sh | sh

It installs the Mac app and the Switch CLI. Run it again to update.

Or download the .dmg, open it, and drag Switch to Applications.

Then:

  1. Open Switch, or run ~/.local/bin/switch in a terminal.
  2. Choose Add Account and follow the sign-in steps for your tool.
  3. Check usage and choose the account you want to use.
Linux (x86_64 or arm64)

Run this in a terminal:

curl -fsSL https://raw.githubusercontent.com/surajmandalcell/switch/master/install.sh | sh

It installs the Switch CLI, a full terminal app, in ~/.local/bin. Run it again to update.

Then run switch, choose Add Account, and follow the sign-in steps for your tool.

Requirements and install locations

Install each coding tool separately. The Mac app goes in ~/Applications, and terminal commands go in ~/.local/bin. The installer needs no administrator access and keeps your account data in place.

Learn more

Screenshots

Overview with daily tokens and an activity calendar

Account trends Light appearance
Account trends and share of tokens Overview in light mode
Menu bar in dark mode Menu bar in light mode
Account limits and reset times in dark mode Account limits and reset times in light mode

Accounts grouped by tool with usage and default controls

App screenshots show real usage with email addresses hidden. Menu bar screenshots use Preview sample data.

Accounts and access

Switch changes the selected tool's login while preserving its local settings and workspace data. It saves the outgoing login and backs up replaced data. Each tool has its own default account.

Tool or provider What selecting an account does
Codex CLI Replaces its auth file. Running sessions may need to reopen to use the new account.
Grok Build Replaces its auth file, which the CLI reloads before its next API call.
Claude Code Uses a separate account profile with shared local conversations and settings. The default applies to launches through Switch; optional terminal integration also covers plain claude commands.
Droid / Factory Replaces auth files and updates eligible local conversation headers for the selected organization. Original session IDs and message bodies remain intact. Active writers defer this step until a safe retry.
File-backed integrations, including Gemini CLI, Cursor, Kimi Code, and Kiro Change only the selected tool's supported auth files or entries. Support differs by client; Cursor editor switching does not switch Cursor CLI. Quit the affected app before switching.
API-key and session providers Save credentials and check usage. Selecting a default does not generally change a coding tool's login.

Local history and cloud access are separate. Droid cloud missions stay with their owner. Codex account rules can restrict which conversations a different account can resume. Other tools can also require the original account for cloud history or attachments.

Use Switch in the terminal

Run without a global install:

npx --yes @smdl/switch

Or install and update globally:

npm install --global @smdl/switch@latest
switch

The terminal uses the same account store and switching engine as the Mac app. Use arrow keys to move, Enter to select, and Escape to go back. ai-manager is also available as an alias.

switch --version
switch providers
switch usage --json
switch guard --provider codex --min-remaining 10
switch help

The npm package supports Apple Silicon Macs only. The shared core and CLI also run on Linux when built from source.

History, backups, and privacy

Search local conversations and review token use by account, model, or project. Preview Cleanup changes before moving conversations and caches to recoverable trash. Back up chats and settings to a folder or drive, or export your prompts as Markdown.

Hide email addresses or use Privacy mode for stable account aliases. Switch does not read the macOS Keychain or browser cookie stores. Providers that need a browser session accept a pasted session instead.

Build it yourself

See Build and check for the Mac app, the CLI, and the tests. Run make tui from a source checkout to start the terminal interface.

Security policy · Release notes

Usage integrations include work adapted from OpenUsage and CodexBar.


Open source apps can look this good. If you agree, a star on GitHub helps more people find Switch.
⭐ Star Switch on GitHub

License

Switch is released under the MIT license.

About

MacOS application to let you easily switch AI Sub accounts keeping your conversations intact, keeping your conversations intact.

Topics

Resources

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages