explaingit

hoangpm96/ai-switcher

20RustAudience · developerComplexity · 2/5Setup · moderate

TLDR

macOS desktop app that lets you log in to multiple Claude Code, Codex, and Antigravity IDE accounts and switch between them instantly, including automatic switching when your quota runs out.

Mindmap

mindmap
  root((ai-switcher))
    What it does
      Switch AI accounts
      Quota monitoring
      Auto-switch on limit
    Supported tools
      Claude Code
      Codex
      Antigravity IDE
    How it works
      Config folders per account
      Named terminal commands
      IDE database patching
    Setup
      macOS drag install
      Bypass security warning
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Run two separate Claude Code subscriptions in parallel terminal windows and switch the active account with one aisw command

USE CASE 2

Automatically rotate to a backup Codex account when your primary account hits its monthly usage limit

USE CASE 3

Manage multiple Antigravity IDE logins without manually signing out each time, the switcher patches the IDE database and relaunches it

Tech stack

RustmacOS

Getting it running

Difficulty · moderate Time to first run · 30min

Unsigned app, macOS shows a security warning on first launch that requires a right-click bypass, requires multiple paid AI tool subscriptions to be useful.

License terms are not mentioned in the explanation.

In plain English

AI Account Switcher is a macOS desktop app for people who use multiple subscription accounts across AI coding tools. It targets three tools specifically: Claude Code (an AI coding assistant that runs in the terminal), Codex (a similar terminal-based tool from OpenAI), and Antigravity IDE (a code editor with built-in AI). If you pay for more than one account on any of these services, this app lets you log in to all of them and switch between them without manually signing out and back in. For the two command-line tools, Claude Code and Codex, the app sets up a separate configuration folder for each account and creates a named command for each one, so you can run multiple accounts at the same time in different terminal windows. The active account, the one that responds when you just type the plain command without a suffix, follows whatever you selected last in the app. Running a short command called aisw in an existing terminal window syncs it to the latest selection. For Antigravity IDE, switching works differently because it is a graphical app. The switcher modifies a database file the IDE uses to store login tokens, then closes and reopens the IDE so the new account takes effect. The app detects accounts by their Google profile photo and flags duplicates automatically. The app also shows quota information, meaning it reads how much of your usage allowance remains for Claude and Codex, and can automatically switch to another account when the active one runs out of quota. Installation is a standard macOS drag-to-Applications flow from a downloaded disk image. Because the app is not signed with a paid Apple developer certificate, macOS will show a security warning on first launch, which you can bypass with a right-click or a one-time terminal command. The README notes that running multiple subscription accounts may violate the terms of service for the tools involved.

Copy-paste prompts

Prompt 1
I have two Claude Code subscription accounts. Using ai-switcher on macOS, how do I set up both accounts so I can switch the active one with the aisw command in an existing terminal window?
Prompt 2
Set up ai-switcher so that when one Claude Code account hits its quota limit it automatically switches to my second account for the rest of the day, show me the quota monitoring configuration.
Prompt 3
Explain how ai-switcher modifies the Antigravity IDE login database to switch accounts, and what risks exist if the IDE is open during a switch.
Prompt 4
I want to run Claude Code account A in one terminal and account B in another at the same time using ai-switcher, walk me through the named-command setup.
Open on GitHub → Explain another repo

← hoangpm96 on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.