whatisgithub

What is z-switch?

ztestai/z-switch — explained in plain English

Analysis updated 2026-05-18

18RustAudience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

A desktop app that lets you one-click switch which AI API provider tools like Claude Code, Codex, or Grok connect to.

Mindmap

mindmap
  root((z-switch))
    What it does
      One-click provider switch
      Direct-write mode
      Local proxy hot-swap
    Tech stack
      Rust
      Tauri
      React
    Use cases
      Manage AI providers
      Test provider speed
      Restore original config
    Audience
      Developers
      Claude Code users

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

What do people build with it?

USE CASE 1

Switch Claude Code or Codex between an official account and a third-party API provider with one click.

USE CASE 2

Test a new API provider's connectivity, model list, and response speed before committing to it.

USE CASE 3

Hot-swap the active provider for a running coding tool using the local proxy mode.

USE CASE 4

Restore original tool configuration after experimenting with different providers.

What is it built with?

RustTauriReactTypeScript

How does it compare?

ztestai/z-switchadindazu/ultimatevocalapplicative-systems/gcan
Stars181818
LanguageRustRustRust
Setup difficultyeasymoderateeasy
Complexity2/52/52/5
Audiencedeveloperdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Download a prebuilt release for your platform or build from source with Tauri and Rust.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

z-switch is a desktop app for people who use AI coding tools like Claude Code, Codex, or Grok through multiple API providers, such as official accounts or third-party relay services. Instead of manually editing configuration files every time you want to switch which provider a tool talks to, z-switch lets you manage several providers as cards and switch between them with one click. It works in two ways. The default mode directly and safely rewrites the coding tool's own configuration files, so the change takes effect the next time that tool reads its config. An experimental second mode runs a small local proxy on your machine, letting you swap which provider is being used while the tool keeps running, without needing to restart it. On first launch, the app saves a copy of your existing Claude Code and Codex settings and automatically builds an official account card, plus imports any relay provider you already had configured. Each provider card can be tested before use: the app can check that the address responds, fetch the list of available models, measure response speed, and send a small real test message to see how long the provider takes to reply. For Claude, you can configure separate settings for its different model tiers, for Codex you can choose between two connection styles, Grok uses a single model with a configurable context size. The app can also optionally sync your provider choice to the separate Claude desktop chat app and to the Claude Code extension for VS Code. All data stays on the device: there is no cloud upload or usage tracking, and API keys or test message contents are never written to log files. Every configuration change is saved atomically with a backup taken beforehand, and the original settings from before you ever used z-switch can be restored at any time. The project is open source under the MIT license, contains no ads, and states it carries no referral links. It is built with Tauri, Rust, React, and TypeScript, and runs on Windows, macOS, and Linux.

Copy-paste prompts

Prompt 1
Explain how to install and set up z-switch to manage my Claude Code providers.
Prompt 2
How does the local proxy mode let me hot-swap providers without restarting my tool?
Prompt 3
Walk me through how z-switch backs up and restores my original configuration files.
Prompt 4
What's the difference between direct-write mode and local routing mode in z-switch?
Prompt 5
Summarize how z-switch keeps API keys and test data private and off disk logs.

Frequently asked questions

What is z-switch?

A desktop app that lets you one-click switch which AI API provider tools like Claude Code, Codex, or Grok connect to.

What language is z-switch written in?

Mainly Rust. The stack also includes Rust, Tauri, React.

What license does z-switch use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is z-switch to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is z-switch for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.