# saladday/cc-switch-cli

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/saladday-cc-switch-cli).**

_How this analysis was created: the description and tags below were written by an AI model that read this project's README and public documentation pages; stars, license and language come straight from the GitHub API. The model does not read the source code._

5,452 stars · 335 forks · Rust · MIT

## Links

- GitHub: https://github.com/SaladDay/cc-switch-cli
- awesome-repositories: https://awesome-repositories.com/repository/saladday-cc-switch-cli.md

## Description

cc-switch-cli is a cross-platform command-line tool, written in Rust, that manages provider, prompt, MCP server and skill settings for several AI coding assistants from one place. It targets assistants such as Claude Code, Codex, Gemini CLI, OpenCode, Hermes, OpenClaw and Pi, selected through a single global app flag, so their configuration files do not need to be edited separately. It can be used through a full-screen terminal interface, with English and Chinese language options, or as non-interactive commands for scripting.

Its central job is switching between third-party model API providers and accounts. Provider profiles support multiple endpoints, API key storage, remote model discovery, and speed or stream health checks. A provider can also be applied to a single terminal session without changing the global setting, and Codex sessions can be shared across providers so a conversation continues after a switch. A managed local proxy can route assistant requests to providers and adapt between different API formats, with help for diagnosing port conflicts and stale background processes. OAuth accounts for ChatGPT and Codex can be logged in through a device flow, listed, removed, and bound to providers.

Beyond providers, the tool configures Model Context Protocol servers once and syncs them to multiple assistants over stdio, http and sse transports. It also stores system prompt presets, installs and syncs community skills, and reviews saved session history with resume commands and a 30-day usage and cost overview. Configuration can be backed up with named, rotated backups, imported and exported, and synced across devices through WebDAV. Diagnostics detect environment variables that override settings and check whether the required assistant tools are installed.

The binary installs through a quick install script, Homebrew, or a source build. Shell completions are installed automatically for bash and zsh, and the project can also be built as a library-only crate by disabling the default command-line feature.

## Tags

### Development Tools & Productivity

- [AI Assistant Configurations](https://awesome-repositories.com/f/development-tools-productivity/ai-assistant-configurations.md) — Manages configuration for several AI coding assistants such as Claude Code, Codex, Gemini CLI and OpenCode from one command-line tool. ([source](https://github.com/saladday/cc-switch-cli#readme))
- [AI Coding Assistants](https://awesome-repositories.com/f/development-tools-productivity/ai-coding-assistants.md) — Manages provider, prompt, MCP server, and skill settings for several AI coding assistants from one command-line tool.
- [Configuration Syncing](https://awesome-repositories.com/f/development-tools-productivity/local-file-syncing/remote-repository-syncing/configuration-syncing.md) — Creates named, rotated backups, imports and exports settings, manages common snippets and syncs configuration to a remote store. ([source](https://github.com/saladday/cc-switch-cli#readme))
- [Terminal Coding Assistants](https://awesome-repositories.com/f/development-tools-productivity/terminal-coding-assistants.md) — Provides a full-screen terminal interface for switching provider profiles, accounts, and models across coding assistants without hand-editing configuration files.

### Artificial Intelligence & ML

- [AI Provider Managers](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-provider-managers.md) — Switches between API provider profiles for many coding assistants, with multiple endpoints, stored API keys, remote model discovery, and speed or stream health checks. ([source](https://github.com/saladday/cc-switch-cli#readme))
- [Cross-Assistant MCP Server Syncing](https://awesome-repositories.com/f/artificial-intelligence-ml/cross-assistant-mcp-server-syncing.md) — Configures MCP servers once and syncs them to several assistants over stdio, http and sse, with authenticated headers for remote servers. ([source](https://github.com/saladday/cc-switch-cli#readme))
- [MCP Server Synchronizations](https://awesome-repositories.com/f/artificial-intelligence-ml/mcp-server-synchronizations.md) — Configures Model Context Protocol servers once and syncs them to several coding assistants over stdio, http, and sse with authenticated headers.
- [Model API Provider Profiles](https://awesome-repositories.com/f/artificial-intelligence-ml/model-api-provider-profiles.md) — Registers external model API services as provider entries that a coding assistant can be pointed at and switched to. ([source](https://github.com/saladday/cc-switch-cli#readme))
- [Runtime Provider Switching](https://awesome-repositories.com/f/artificial-intelligence-ml/model-provider-configurations/runtime-provider-switching.md) — Switches between third-party model API providers and accounts for coding assistants, including per-terminal overrides, without manual file edits.
- [Provider Config Writers](https://awesome-repositories.com/f/artificial-intelligence-ml/provider-connection-checks/model-provider-settings/provider-config-writers.md) — Writes the chosen provider's settings into each assistant's config directory on switch, skipping uninitialized assistants with a warning. ([source](https://github.com/saladday/cc-switch-cli#readme))
- [Central Skill Syncing](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/agent-capabilities-skills-tooling/agent-skill-frameworks/skill-installation/central-skill-syncing.md) — Stores skills centrally, enables them per assistant, syncs to app directories, checks updates, imports unmanaged skills and searches a marketplace. ([source](https://github.com/saladday/cc-switch-cli#readme))
- [Local LLM API Servers](https://awesome-repositories.com/f/artificial-intelligence-ml/machine-learning/infrastructure/model-deployment-and-serving/local-and-on-device-inference/local-api-servers/local-llm-api-servers.md) — Runs a managed local proxy that routes coding assistant requests to third-party model providers and adapts between API formats.
- [MCP Configuration Sync Tools](https://awesome-repositories.com/f/artificial-intelligence-ml/mcp-configuration-sync-tools.md) — Configures Model Context Protocol servers once and syncs them to multiple coding assistants across stdio, http, and sse transports.
- [Per-Session Provider Overrides](https://awesome-repositories.com/f/artificial-intelligence-ml/per-session-provider-overrides.md) — Launches Claude or Codex with a chosen provider for one terminal session only, so several terminals can use different providers at once. ([source](https://github.com/saladday/cc-switch-cli#readme))

### Networking & Communication

- [Local Traffic Interception Proxies](https://awesome-repositories.com/f/networking-communication/local-traffic-interception-proxies.md) — Runs a managed local proxy per assistant that routes requests to providers and adapts between different API formats. ([source](https://github.com/saladday/cc-switch-cli#readme))
- [API Client Proxying](https://awesome-repositories.com/f/networking-communication/traffic-proxying/proxy-traffic-management/api-client-proxying.md) — Routes coding assistant API traffic through a managed local proxy that adapts between model API formats.
- [WebDAV Configuration Synchronization](https://awesome-repositories.com/f/networking-communication/webdav-configuration-synchronization.md) — Backs up, rotates, and synchronizes assistant settings across devices through a WebDAV server.

### Security & Cryptography

- [Device Flow Logins](https://awesome-repositories.com/f/security-cryptography/oauth-authentication/oauth-account-lifecycle-managers/device-flow-logins.md) — Logs in to ChatGPT and Codex accounts through a device flow, lists and removes them, sets a default, and binds them to providers. ([source](https://github.com/saladday/cc-switch-cli#readme))

### Software Engineering & Architecture

- [Prompt Presets](https://awesome-repositories.com/f/software-engineering-architecture/project-management-governance/project-management/project-lifecycle-management/project-configuration-presets/configuration-presets/prompt-presets.md) — Stores reusable system prompt presets and writes them to each assistant's native prompt file for consistent instructions. ([source](https://github.com/saladday/cc-switch-cli#readme))

### User Interface & Experience

- [Provider Switching Dashboards](https://awesome-repositories.com/f/user-interface-experience/interactive-ui-elements/interaction-controllers/terminal-display-controllers/terminal-ui-widgets/provider-switching-dashboards.md) — Offers a full-screen terminal interface with English and Chinese options for switching providers, managing accounts, reviewing sessions and inspecting proxy status. ([source](https://github.com/saladday/cc-switch-cli#readme))
