Cross-tool · Tested with aisw v0.3.7 · Updated July 16, 2026
Switch Claude Code, Codex CLI, and Gemini CLI Together
Create an aisw context that maps a Claude Code, Codex CLI, and Gemini CLI profile together with aisw context create <name> --claude <p> --codex <p> --gemini <p>, then run aisw context use <name> to switch all three at once.
If you use Claude Code, Codex CLI, and Gemini CLI together on the same project — say, for a client engagement where all three need to authenticate as that client — switching each one individually after every context change gets old fast. A context collapses that into one command.
Set it up
1. Make sure you have a profile per tool for this setup.
aisw add claude client-acme --from-liveaisw add codex client-acme --api-key "$CLIENT_ACME_OPENAI_KEY"aisw add gemini client-acme2. Group them into a context.
aisw context create client-acme \ --claude client-acme \ --codex client-acme \ --gemini client-acmeThe context name and the profile names don’t have to match — using the same name for both here is just convenient, not required.
3. Switch everything at once.
aisw context use client-acme4. Switch back just as easily.
aisw context use personal(Assuming a personal context exists with the same structure.)
Desktop method (coming soon)
AI Switcher Desktop is currently in private testing and not yet available for public download. The steps below reflect the current build; use the CLI method above until it ships.
Screenshot placeholder
AI Switcher Desktop Contexts screen showing the client-acme context with Claude Code, Codex CLI, and Gemini CLI profiles mapped, and an Activate button
- Open Contexts in AI Switcher Desktop.
- Click New context, name it, and map a profile from each tool.
- Click Activate to switch all mapped tools together.
Verify the result
aisw statusConfirms the active profile for each tool and, if they match a defined context, names it — so you can tell at a glance the whole setup switched correctly.
Common problems
If aisw context use only switches some of the tools, check that the context actually maps a profile for each one with aisw context show client-acme — a tool left out of the mapping is left untouched by design, not a bug.
Frequently asked questions
Do I need a profile for all three tools to create a context?
No. A context can map just the tools you actually use — one, two, or all three. aisw only switches the tools included in the context.
What happens to a tool that isn't part of the context I switch to?
It's left untouched. Switching a context only changes the active profile for the tools that context explicitly maps.