cc-switch: All-in-One Assistant for Claude Code, Codex & Gemini CLI

CC-Switch: All-in-One Assistant for Claude Code, Codex & Gemini CLI

Overview

CC-Switch is a powerful, cross-platform desktop tool designed to streamline the management of AI command-line interfaces (CLIs) for leading models like Claude Code (from Anthropic), Codex (OpenAI), and Gemini CLI (Google). Originally starting as a simple provider switcher, it has evolved into a comprehensive platform that handles configurations, extensions, and integrations for AI-driven coding workflows. Built with modern technologies like Tauri (Rust backend) and React (TypeScript frontend), it supports Windows, macOS, and Linux, making it accessible to developers across ecosystems.

The tool addresses common pain points in AI CLI usage, such as juggling multiple API keys, endpoints, and custom configurations across different providers. With over 5,800 stars on GitHub and trending status in TypeScript repositories, CC-Switch has quickly become a go-to utility for AI enthusiasts and professional developers seeking efficient setup management without manual file editing.

Key Features

Provider Management

• One-Click Switching: Easily toggle between providers like Anthropic's Claude, OpenAI's Codex, and Google's Gemini. Supports granular model selection (e.g., Haiku, Sonnet, Opus for Claude) and custom endpoints.
• Speed Testing: Built-in latency measurement for API endpoints, with visual indicators to choose the fastest and most reliable options.
• Import/Export and Backups: Automatic rotation of up to 10 recent backups, ensuring safe configuration handling. Deep link protocol (ccswitch://) allows sharing configs via links with security validation.
• Environment Conflict Detection: Automatically identifies and resolves conflicts between apps (Claude/Codex/Gemini), providing suggestions and overrides with warnings.

MCP (Model Context Protocol) Management

• Unified Architecture: Single panel for managing MCP servers across all three CLIs. Supports stdio, HTTP, and SSE transport types.
• Templates and Sync: Pre-built templates (e.g., mcp-fetch, mcp-filesystem) and bidirectional sync to live config files (e.g., ~/.claude.json for Claude).
• Import/Export: Handles JSON and TOML formats, with auto-correction for Codex's config.toml.

Skills and Prompts Systems (Introduced in v3.7.0)

• Skills Management: Auto-scans GitHub repositories (including Anthropic official, ComposioHQ, and community-curated ones) for Claude Skills. One-click install/uninstall to ~/.claude/skills/, with support for recursive subdirectory scanning and custom repos.
• Prompts Management: Unlimited presets for system prompts, editable via a Markdown editor with real-time preview (powered by CodeMirror 6). Cross-app sync to files like CLAUDE.md (Claude), AGENTS.md (Codex), and GEMINI.md (Gemini). Includes smart backfill to protect manual edits.

System and UI Enhancements (v3.8.0 Major Update)

• Persistence Upgrade: Dual-layer architecture with SQLite for syncable data (providers, MCP, prompts, skills) and JSON for device-specific settings. Enables future cloud sync via custom directories (e.g., Dropbox, OneDrive).
• Redesigned UI: Modern layout with Tailwind CSS, smoother animations, and improved visual hierarchy. Full i18n support for English, Chinese, and Japanese.
• Auto-Launch and Tray Integration: Native startup options and system tray for quick access. Single-instance daemon prevents duplicates.
• Cloud Sync Ready: Set custom config directories for multi-device synchronization without manual intervention.

Installation and Usage

System Requirements

• Windows 10+, macOS 10.15+, Linux (Ubuntu 22.04+, Debian 11+, Fedora 34+).

Download Options

• Windows: MSI installer or portable ZIP from Releases.
• macOS: Homebrew (brew install --cask cc-switch) or ZIP download (note: may require 'Open Anyway' in Security settings).
• Linux: DEB package or AppImage; Arch users can use paru -S cc-switch-bin.

Quick Start

1. Launch CC-Switch and add a provider via presets (e.g., Official Claude Login, PackyCode for Gemini) or custom setup.
2. Enable the provider; restart your CLI (e.g., terminal for Gemini) to apply.
3. Manage MCP/Skills/Prompts from the top-right tabs.
4. Use the tray icon for instant switches.

For advanced users, WSL support auto-syncs on directory changes, and the built-in updater handles seamless upgrades.

Architecture and Development

CC-Switch follows a layered design:

• Frontend: React 18, TypeScript, Vite, Tailwind CSS 3.4, TanStack Query for state management.
• Backend: Tauri 2.8, Rust for secure, native performance. Services handle CRUD operations with atomic writes and mutex protection.
• Storage: Single Source of Truth in ~/.cc-switch/cc-switch.db (SQLite), with backups in ~/.cc-switch/backups/.
• Testing: 100% coverage with Vitest, MSW for mocks, and integration tests for core flows.

Development requires Node.js 18+, pnpm 8+, Rust 1.85+. Commands include pnpm dev for hot reload and cargo test for backend.

Sponsorships and Community

Sponsored by Z.ai (GLM CODING PLAN with 10% off), PackyCode (API relay with discounts), and ShanDianShuo (local AI voice input). Contributions welcome via issues/PRs, with guidelines for type checks and tests.

Legacy Support

v2.0.3 Electron version available for older setups; migrate to Tauri for better performance.

Released under MIT License by Jason Young. For changelog, see CHANGELOG.md. Star history shows rapid growth since inception.