CC-Switch CLI

CC-Switch CLI is an open-source, MIT-licensed CLI fork of the CC-Switch project, built in Rust and maintained by saladday on GitHub. It provides a unified interactive TUI and scriptable command-line interface for managing API providers, MCP servers, system prompts, skills, sessions, and proxy routes across seven AI coding assistants. The project reached version 5.10.5 as of September 2026 and has accumulated over 5,000 GitHub stars.

What It Is

CC-Switch CLI is a cross-platform terminal tool that acts as a single switchboard for AI coding CLI tools. Instead of manually editing config files for each assistant, developers use one cc-switch command to switch providers, manage OAuth accounts, sync MCP servers, activate prompt presets, and inspect proxy status — all from a full-screen TUI or scriptable subcommands. It targets Claude Code, Codex, Gemini, OpenCode, Hermes, OpenClaw, and Pi.

Supported Apps and Provider Management

The --app flag selects which assistant to manage; claude is the default. For each supported app, CC-Switch can:

• List, add, edit, duplicate, delete, and switch API providers with one command
• Export a Claude provider to a standalone settings.local.json for auto-load
• Run speed tests and stream health checks per provider
• Fetch remote model lists from configured endpoints
• Route Claude Code, Codex, and Gemini through a local proxy that adapts OpenAI Responses API, Chat Completions, and Anthropic Messages-compatible providers, as well as mainstream OpenAI-compatible models such as DeepSeek, Kimi, Qwen, OpenRouter, xAI, Groq, and Mistral

MCP Server and Skills Management

CC-Switch provides unified MCP server management across Claude, Codex, Gemini, OpenCode, and Hermes, supporting stdio, HTTP, and SSE transports with authenticated remote-server headers and automatic sync to live config files. The skills system uses a single source of truth (SSOT) directory under ~/.cc-switch/skills/, with per-app enable/disable, symlink or copy sync methods, marketplace search via skills.sh, and repository-backed update tracking.

Architecture and Storage

The tool is built in Rust 1.85+ using ratatui for the TUI layer. Core state lives in a SQLite database at ~/.cc-switch/cc-switch.db, with atomic writes (temp file + rename) to prevent corruption and RwLock concurrency guards. Key design points:

• Safe Live Sync: skips writing live config files for apps that have not been initialized, preventing unexpected directory creation
• WebDAV sync: compatible with the upstream CC-Switch GUI project for cross-device config sharing
• Daemon-managed proxy: Unix-domain-socket supervisor auto-starts one worker per active app proxy route on macOS and Linux; Windows users run the proxy in foreground mode instead
• Library-only builds: embedding consumers can omit CLI/TUI dependencies via Cargo feature flags

Session History and Usage Statistics

The sessions subcommand provides paged history across all supported apps, message preview, copyable resume commands, and safe deletion. sessions sync-usage --all imports local session logs into token and cost statistics, with per-model breakdowns visible on the TUI home page's 30-day usage view.

Update: v5.10.5

The latest release is v5.10.5, published on September 15, 2026. The project has been actively developed since its creation in November 2025, with 301 forks and 71 open issues at the time of data collection. Recent additions include Pi provider support (following Pi's native additive model), shared persistent Codex session history across providers, shell completion management (completions install --activate), and daemon-managed proxy workers with per-app listen ports. The WebDAV sync feature remains fully compatible with the upstream CC-Switch GUI project.