Want to appear here?

Modern AI-powered coding relies on tools like Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, OpenClaw, and Hermes — but each has its own configuration format. Switching API providers means manually editing JSON, TOML, or .env files, and there is no unified way to manage MCP and Skills across multiple tools.

CC Switch gives you a single desktop app to manage all supported AI tools. Instead of editing config files by hand, you get a visual interface to import providers with one click, switch between them instantly, with 50+ built-in provider presets, unified MCP and Skills management, and system tray quick switching — all backed by a reliable SQLite database with atomic writes that protect your configs from corruption.

• One App, Seven Tools — Manage Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, OpenClaw, and Hermes from a single interface
• No More Manual Editing — 50+ provider presets including AWS Bedrock, NVIDIA NIM, and community relays; just pick and switch
• Unified MCP & Skills Management — One panel to manage MCP servers and Skills across Claude, Codex, Gemini, OpenCode, and Hermes with bidirectional sync
• System Tray Quick Switch — Switch providers instantly from the tray menu, no need to open the full app
• Cloud Sync — Sync provider data across devices via Dropbox, OneDrive, iCloud, or WebDAV servers
• Cross-Platform — Native desktop app for Windows, macOS, and Linux, built with Tauri 2
• Built-in Utilities — Includes various utilities for first-launch login confirmation, signature bypass, plugin extension sync, and more

Full Changelog | Release Notes

• 7 supported tools, 50+ presets — Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, OpenClaw, Hermes; copy your key and import with one click
• Universal providers — One config syncs to Claude Code, Codex, and Gemini CLI
• One-click switching, system tray quick access, drag-and-drop sorting, import/export

• Local proxy with hot-switching — Format conversion, auto-failover, circuit breaker, provider health monitoring, and request rectifier
• App-level takeover — Independently proxy Claude, Codex, or Gemini, down to individual providers

• Unified MCP panel — Manage MCP servers across Claude, Codex, Gemini, OpenCode, and Hermes with bidirectional sync and Deep Link import
• Prompts — Markdown editor with cross-app sync (CLAUDE.md / AGENTS.md / GEMINI.md) and backfill protection
• Skills — One-click install from GitHub repos or ZIP files, custom repository management, with symlink and file copy support

• Usage dashboard — Track spending, requests, and tokens with trend charts, detailed request logs, and custom per-model pricing

• Browse, search, and restore conversation history across supported session sources
• Workspace editor (OpenClaw) — Edit agent files (AGENTS.md, SOUL.md, etc.) with Markdown preview

• Cloud sync — Custom config directory (Dropbox, OneDrive, iCloud, NAS) and WebDAV server sync
• Deep Link (ccswitch://) — Import providers, MCP servers, prompts, and skills via URL
• Dark / Light / System theme, auto-launch, auto-updater, atomic writes, auto-backups, i18n (zh/zh-TW/en/ja)

For detailed guides on every feature, check out the User Manual — covering provider management, MCP/Prompts/Skills, proxy & failover, and more.

1. Add Provider: Click "Add Provider" → Choose a preset or create custom configuration
2. Switch Provider:
   • Main UI: Select provider → Click "Enable"
   • System Tray: Click provider name directly (instant effect)
3. Takes Effect: Restart your terminal or the corresponding CLI tool to apply changes (Claude Code does not require a restart)
4. Back to Official: Add an "Official Login" preset, restart the CLI tool, then follow its login/OAuth flow

• MCP: Click the "MCP" button → Add servers via templates or custom config → Toggle per-app sync
• Prompts: Click "Prompts" → Create presets with Markdown editor → Activate to sync to live files
• Skills: Click "Skills" → Browse GitHub repos → One-click install to supported apps
• Sessions: Click "Sessions" → Browse, search, and restore conversation history across supported session sources

Note: On first launch, you can manually import existing CLI tool configs as the default provider.

• Windows: Windows 10 and above
• macOS: macOS 12 (Monterey) and above
• Linux: Ubuntu 22.04+ / Debian 11+ / Fedora 34+ and other mainstream distributions

Download the latest CC-Switch-v{version}-Windows.msi installer or CC-Switch-v{version}-Windows-Portable.zip portable version from the Releases page.

Method 1: Install via Homebrew (Recommended)

brew install --cask cc-switch

Update:

brew upgrade --cask cc-switch

Method 2: Manual Download

Download CC-Switch-v{version}-macOS.dmg (recommended) or .zip from the Releases page.

Note: CC Switch for macOS is code-signed and notarized by Apple. You can install and open it directly.

Install via paru (Recommended)

paru -S cc-switch-bin

Download the latest Linux build from the Releases page:

• CC-Switch-v{version}-Linux.deb (Debian/Ubuntu)
• CC-Switch-v{version}-Linux.rpm (Fedora/RHEL/openSUSE)
• CC-Switch-v{version}-Linux.AppImage (Universal)

Flatpak: Not included in official releases. You can build it yourself from the .deb — see flatpak/README.md for instructions.

┌─────────────────────────────────────────────────────────────┐
│ Frontend (React + TS) │
│ ┌─────────────┐ ┌──────────────┐ ┌──────────────────┐ │
│ │ Components │ │ Hooks │ │ TanStack Query │ │
│ │ (UI) │──│ (Bus. Logic) │──│ (Cache/Sync) │ │
│ └─────────────┘ └──────────────┘ └──────────────────┘ │
└────────────────────────┬────────────────────────────────────┘
 │ Tauri IPC
┌────────────────────────▼────────────────────────────────────┐
│ Backend (Tauri + Rust) │
│ ┌─────────────┐ ┌──────────────┐ ┌──────────────────┐ │
│ │ Commands │ │ Services │ │ Models/Config │ │
│ │ (API Layer) │──│ (Bus. Layer) │──│ (Data) │ │
│ └─────────────┘ └──────────────┘ └──────────────────┘ │
└─────────────────────────────────────────────────────────────┘

# Install dependencies
pnpm install
# Dev mode (hot reload)
pnpm dev
# Type check
pnpm typecheck
# Format code
pnpm format
# Check code format
pnpm format:check
# Run frontend unit tests
pnpm test:unit
# Run tests in watch mode (recommended for development)
pnpm test:unit:watch
# Build application
pnpm build
# Build debug version
pnpm tauri build --debug

cd src-tauri
# Format Rust code
cargo fmt
# Run clippy checks
cargo clippy
# Run backend tests
cargo test
# Run specific tests
cargo test test_name
# Run tests with test-hooks feature
cargo test --features test-hooks

# Run all tests
pnpm test:unit
# Watch mode (auto re-run)
pnpm test:unit:watch
# With coverage report
pnpm test:unit --coverage

├── src/ # Frontend (React + TypeScript)
│ ├── components/
│ │ ├── providers/ # Provider management
│ │ ├── mcp/ # MCP panel
│ │ ├── prompts/ # Prompts management
│ │ ├── skills/ # Skills management
│ │ ├── sessions/ # Session Manager
│ │ ├── proxy/ # Proxy mode panel
│ │ ├── openclaw/ # OpenClaw config panels
│ │ ├── settings/ # Settings (Terminal/Backup/About)
│ │ ├── deeplink/ # Deep Link import
│ │ ├── env/ # Environment variable management
│ │ ├── universal/ # Cross-app configuration
│ │ ├── usage/ # Usage statistics
│ │ └── ui/ # shadcn/ui component library
│ ├── hooks/ # Custom hooks (business logic)
│ ├── lib/
│ │ ├── api/ # Tauri API wrapper (type-safe)
│ │ └── query/ # TanStack Query config
│ ├── locales/ # Translations (zh/zh-TW/en/ja)
│ ├── config/ # Presets (providers/mcp)
│ └── types/ # TypeScript definitions
├── src-tauri/ # Backend (Rust)
│ └── src/
│ ├── commands/ # Tauri command layer (by domain)
│ ├── services/ # Business logic layer
│ ├── database/ # SQLite DAO layer
│ ├── proxy/ # Proxy module
│ ├── session_manager/ # Session management
│ ├── deeplink/ # Deep Link handling
│ └── mcp/ # MCP sync module
├── tests/ # Frontend tests
└── assets/ # Screenshots & partner resources

Issues and suggestions are welcome!

Before submitting PRs, please ensure:

• Pass type check: pnpm typecheck
• Pass format check: pnpm format:check
• Pass unit tests: pnpm test:unit

For new features, please open an issue for discussion before submitting a PR. PRs for features that are not a good fit for the project may be closed.

Star History Chart

MIT © Jason Young