SaladDay/cc-switch-cli
Developer ToolsA cross-platform CLI and TUI for switching API providers, MCP servers, prompts, skills and sessions across seven AI coding assistants.
What it does
CC-Switch CLI is a Rust-based command-line and terminal-UI tool that centralizes configuration for seven AI coding assistants: Claude Code, Codex, Gemini, OpenCode, Hermes, OpenClaw and Pi. Instead of hand-editing each tool's settings files, you can register providers, switch the active one, sync MCP servers, manage system-prompt presets and community skills, review saved sessions and track token/cost usage from one place. It is a CLI fork of the CC-Switch GUI project, and WebDAV sync remains compatible with upstream.
A local proxy layer can route Claude Code, Codex and Gemini traffic through CC-Switch, adapt OpenAI Responses/Chat Completions providers, and let Codex use Anthropic Messages-compatible endpoints. This is useful for developers juggling several API accounts or relay services across terminals.
Quick start
Install on macOS or Linux with the release installer, which places cc-switch in ~/.local/bin:
curl -fsSL https://github.com/SaladDay/cc-switch-cli/releases/latest/download/install.sh | bash
On macOS you can also use brew install cc-switch-cli. Windows users should download the x64 zip from releases and put cc-switch.exe on PATH.
Launch the TUI with no arguments:
cc-switch
Then add a provider, set it as active, and verify the result. In scripted mode the key commands are:
cc-switch provider list # list providers
cc-switch provider switch <id> # switch the global provider
cc-switch use <id> # shortcut for switching
cc-switch --app codex provider list # target another app
If a switch appears not to take effect, confirm the target CLI has been initialized (its config directory exists) and check for conflicting environment variables with cc-switch env check --app claude.
Usage constraints
The managed proxy daemon relies on a Unix-domain-socket supervisor and works only on macOS and Linux; on Windows, proxy enable, proxy disable and the daemon subcommand fail, and foreground cc-switch proxy serve --takeover claude must be used instead. proxy show and proxy config work on all platforms. Building from source requires Rust 1.85+ and runs from the src-tauri directory.
State is stored in SQLite at ~/.cc-switch/cc-switch.db by default, with skills under ~/.cc-switch/skills/ and auto-rotating backups (10 kept). Set CC_SWITCH_CONFIG_DIR to relocate the config root; existing data is not migrated automatically. Live sync skips apps that have not been initialized, and environment variables such as ANTHROPIC_API_KEY can override the managed configuration. Shared Codex sessions require macOS/Linux and persistent launch directories. Automated shell completion targets bash and zsh only. The project is MIT licensed.
HotRepo's take
On 2026-11-18 the repository held 2nd place on the Rust daily list with 18 new stars that day, putting a CLI for AI coding assistants among the more visible Rust projects of that cycle. The feature set is unusually broad for a fork — provider switching, MCP sync, prompts, skills, sessions and a proxy — and that breadth is also the main caution: the proxy path is platform-split, and several features depend on the target CLIs being initialized first. The README's sponsor table lists several paid API relay services; that does not change what the tool does, but users should treat those as third-party services with their own terms.
Written by AI from the project's README, updated . The project's own docs are the source of truth.
You might also like
- yynxxxxx/Codex-XCross-platform desktop GUI for managing Codex prompts, providers, sessions, Skills and MCP
- chenhg5/cc-connectBridge local AI coding agent CLIs to chat platforms so you can drive agents from any device.
- farion1231/cc-switchA desktop app that switches API providers and centralizes MCP, skills, prompts, sessions and usage for AI coding CLIs.
- zhukunpenglinyutong/jetbrains-cc-guiA JetBrains IDE plugin that wraps Claude Code, Codex and other AI coding CLIs in a visual chat interface.
- google-gemini/gemini-api-cliA Go CLI that lets coding agents and shell scripts call Gemini models, generate media, analyze files, and run managed agents.