Credential locations
Claude Code stores credentials in the macOS Keychain or local files, depending on how it was installed. Codex CLI stores credentials in auth.json or a system keyring. Gemini CLI stores credentials in files under ~/.gemini. AI Switcher reads from and writes to whichever location the installed version of each tool already uses. For exact paths and keyring specifics per tool, see the CLI reference for supported tools.
Keyring behavior
Where a tool uses a system keyring, AI Switcher talks to the platform-native backend directly: Keychain on macOS, Credential Manager on Windows, and Secret Service on Linux. No credential passes through a third-party service to reach the keyring.
Fail-closed cases
Importing a live account fails with an explicit error rather than silently succeeding when the source credential can't be read cleanly — for example, when a Codex auth.json can't be parsed, or when adding a profile would collide with an existing one without--force. AI Switcher does not guess at ambiguous credential state.
State-mode differences
Claude Code and Codex CLI support both isolated and shared state: isolated keeps each profile's local configuration separate, while shared keeps local state common and switches only account credentials. Gemini CLI keeps authentication and local state together under ~/.gemini, so it always runs isolated — a shared mode isn't structurally possible for Gemini today.
Known limitations
AI Switcher Desktop is currently in private testing and not yet publicly available; it will launch for macOS on Apple Silicon first, with Windows and Intel builds to follow. The aisw CLI is available now for macOS (Apple Silicon and Intel), Linux (ARM64 and x64), and Windows x64.
Minimum tested versions
This matrix reflects aisw CLI v0.3.7 and the current AI Switcher Desktop internal build.
Last verification date
Checked against the aisw CLI source on July 16, 2026.