Guides
Task-by-task guides, not just reference docs.
Every guide answers one specific question for Claude Code, Codex CLI, Gemini CLI, or Antigravity CLI, switching an account, keeping work and personal separate, or catching an account mismatch before a repository launch, with both a CLI and a desktop workflow.
Claude Code
Switching, isolating, and binding accounts for Claude Code.
- Claude Code Account per RepositoryBind a repository to the Claude Code account it should use, so aisw can warn or block before the wrong account touches the wrong codebase.
- How to Switch Claude Code AccountsSave each Claude Code account as a named aisw profile and switch between them with one command, from the terminal or AI Switcher Desktop.
- Work and Personal Claude Code AccountsKeep a work and a personal Claude Code account side by side with aisw, and switch between them without editing config files or re-authenticating each time.
Codex CLI
Switching, isolating, and binding accounts for Codex CLI.
- How to Switch Codex CLI AccountsLearn how to switch Codex CLI accounts with named aisw profiles and one command, without copying auth.json by hand.
- Manage Multiple Codex CLI AccountsSave several Codex CLI accounts as named aisw profiles, list them, rename them, and remove the ones you no longer need.
- Use a Codex CLI Account Per RepositoryBind a repository to the Codex CLI profile or context it should use, and let aisw warn or block before the wrong account touches it.
Gemini CLI
Switching and isolating accounts for Gemini CLI.
- How to Switch Gemini CLI AccountsLearn how to switch Gemini accounts with named aisw profiles and one command, keeping Gemini CLI files under ~/.gemini isolated per account.
- Work and Personal Gemini CLI AccountsUse two aisw profiles to keep a work Gemini CLI account and a personal one fully isolated, reducing the chance of state mixing between them.
Antigravity CLI
Switching and managing Antigravity CLI accounts.
- How to Switch Antigravity CLI AccountsLearn how to switch Antigravity CLI accounts with named aisw profiles for work, personal, and client use from the terminal or desktop app.
- Keep Work and Personal Antigravity AccountsStore work and personal Antigravity CLI accounts as separate local aisw profiles and switch between them without repeatedly editing credential files.
Cross-tool workflows
Contexts, client setups, and repository guardrails spanning all supported tools.
- Client Accounts for AI Coding AgentsFor freelancers and consultants: create one aisw context per client, map the tools they use, bind repositories, and switch accounts safely.
- Prevent the Wrong Account in a RepositoryBind a repository to its context and enable guardrails so aisw blocks a coding-agent launch before the wrong account touches the codebase.
- Profiles vs. Contexts in aiswProfiles save one account per tool. Contexts group Claude Code, Codex CLI, Gemini CLI, and Antigravity CLI profiles for one complete switch.
- Switch Claude, Codex, and Gemini TogetherGroup a profile from each tool into one aisw context, then switch your entire coding-agent setup with a single command instead of three.
- Switch Four Coding-Agent Accounts TogetherCreate one aisw context for Claude Code, Codex CLI, Gemini CLI, and Antigravity CLI, then switch the complete coding-agent account setup with one command.
Find the guide by the problem you are trying to solve.
These guides are written around the actual queries people use: switching between two Claude Code accounts, managing multiple Codex CLI accounts, keeping a Gemini CLI or Antigravity CLI work account separate from a personal one, or catching the wrong account before it opens a repository. If you already know the problem, jump to the matching guide instead of reading the full command reference first.
Guides FAQ
This index page exists to route broad search intent to the narrower guide that answers it directly.
Where should I start if I want to switch between two accounts for one tool?
Start with the guide for that tool's switch-accounts workflow. Those pages answer the direct query first, then show the CLI method, the desktop method, and common problems.
Where should I start if I need separate work, personal, and client accounts?
Start with the work-personal guide for one tool, or the cross-tool client-account workflows if the account boundary spans Claude Code, Codex CLI, Gemini CLI, and Antigravity CLI together.
Which guide covers preventing the wrong account in the wrong repository?
Use the cross-tool repository guardrail guide or the per-tool repository guides. Those explain workspace bindings, guard modes, and how AI Switcher catches a mismatch before you launch a coding agent.
Don't see your exact situation?
The documentation covers every command in detail, including common switching situations not written up as a dedicated guide yet.
Install aisw CLI →