Overview
Every coding-agent CLI keeps its own configuration file in its own format, so working across several of them — or pointing one of them at a different provider — means hand-editing dotfiles and restarting terminals. CC Switch replaces that with a single desktop application. It supports eight tools (Claude Code, Claude Desktop, Codex, Gemini CLI, Grok Build, OpenCode, OpenClaw and Hermes Agent), ships more than fifty provider presets, and switches the active provider from the main window or the system tray.
Beyond switching, it runs a local proxy in front of the agents. The proxy converts between request formats, watches provider health and fails over automatically, with a circuit breaker to stop hammering an endpoint that is down. A usage dashboard reports spend, request counts and token totals with trend charts and per-request logs, so the cost of a given provider is visible rather than inferred from a monthly bill.
The app also manages the parts of an agent setup that live outside the provider block. MCP servers are edited in one panel and synced bidirectionally across applications; prompts get a Markdown editor; skills install from GitHub in one click. A session manager browses and restores past conversations, agent files are editable with Markdown preview, and settings sync through Dropbox, OneDrive, iCloud or WebDAV. It is built with Tauri 2 and Rust behind a React front end, and distributed as a native installer rather than an Electron bundle.
What it does
- Eight supported agent CLIs with 50+ provider presets, one-click switching and a system-tray menu
- Local proxy with request-format conversion, health monitoring, auto-failover and a circuit breaker
- Unified MCP server panel with bidirectional sync across applications
- Markdown prompt editor and one-click skill installation from GitHub
- Usage dashboard: spend, requests and tokens with trend charts and per-request logs
- Session manager for browsing and restoring conversation history
- Settings sync over Dropbox, OneDrive, iCloud or WebDAV, plus deep links and an auto-updater
Getting started
CC Switch ships as a native desktop installer for Windows, macOS and Linux. The commands below are the ones given in the project README.
Install on macOS
The Homebrew cask is the quickest route; a `.dmg` is also published on the releases page.
brew install --cask cc-switchInstall on Arch Linux
A prebuilt AUR package is maintained for the binary release.
paru -S cc-switch-binInstall on Windows or other Linux distributions
Download the installer for your platform from the GitHub releases page: `CC-Switch-v{version}-Windows.msi` or a portable `.zip` on Windows, and a `.deb`, `.rpm` or `.AppImage` on Linux.
https://github.com/farion1231/cc-switch/releasesAdd a provider
Open the app and either pick one of the bundled presets or create a custom provider configuration.
Providers → Add → choose a preset, or fill in a custom endpoint and keySwitch and apply
Switch from the main window or the tray icon, then restart the terminal or CLI tool to pick up the change — Claude Code supports hot-switching without a restart. To go back to a vendor's own login, add the official login preset and follow that CLI's OAuth flow.
Tray icon → select provider → restart your CLI (Claude Code switches live)Commands and code are distilled from the project's own documentation — always check the official repo for the latest.
When to use it
- Reach for it when you run more than one coding-agent CLI and are tired of hand-editing a config file per tool
- Reach for it when you want to move a coding agent between providers without re-authenticating from scratch each time
- Reach for it when a provider's reliability is the problem — the local proxy fails over and trips a circuit breaker for you
- Reach for it when you need per-request visibility into what your agent sessions are actually costing
How CC Switch compares
CC Switch alongside other open-source coding-agent harnesses & runtimes tools AI/TLDR tracks, ranked by GitHub stars.
| Tool | Stars | What it does |
|---|---|---|
| CC Switch | ★ 133k | One desktop app that holds the provider configuration for every coding-agent CLI you run |
| Oh My OpenAgent | ★ 69.1k | Opinionated agent bundle for OpenCode and Codex CLI that ships preconfigured sub-agents, lifecycle hooks and built-in MCP servers behind a single ultrawork command. |
| oh-my-claudecode | ★ 39.2k | A plugin and CLI that adds multi-agent orchestration to Claude Code: staged autopilot workflows, parallel tmux workers, and advisors that route a second opinion to Codex, Gemini, Grok or Cursor. |
| herdr | ★ 39k | A single-binary terminal multiplexer built for coding agents: persistent sessions across local and SSH machines, per-pane working/blocked/idle status, and a socket API agents drive themselves. |
| AionUi | ★ 32.9k | An open-source desktop workspace that pairs a built-in agent engine with dozens of external CLI agents, adding scheduled runs, MCP tools and remote access from a WebUI or chat apps. |
| cmux | ★ 27.2k | A Ghostty-based macOS terminal built around coding agents: vertical tabs that show git branch, PR status and ports, attention notifications when an agent needs you, and a scriptable built-in browser. |
| cc-connect | ★ 15.5k | A Go daemon that bridges local coding agents — Claude Code, Codex, Cursor Agent, Gemini CLI, OpenCode, Kimi CLI and more — to Feishu, DingTalk, Slack, Telegram, Discord, LINE and WeCom, so you drive them from chat. |
| Claude Code Haha | ★ 14.5k | A cross-platform desktop workspace for Claude Code: multi-session workspaces, worktree launch, diff review, a built-in browser preview, GUI permission approval, per-session model choice and visual MCP and subagent managers. |