Agent Plugins · Community project

CC Switch

A cross-platform desktop configuration manager for switching providers, MCP servers, prompts, and skills across Claude Code, Codex, Gemini CLI, and other tools.

128.1k StarsMITRustUpdated today
01

Project overview

CC Switch is a agent plugin built around a cross-platform desktop configuration manager for switching providers, MCP servers, prompts, and skills across Claude Code, Codex, Gemini CLI, and other tools. Its value is practical: switch model providers and manage mcp configurations are available from one documented project, while the repository remains inspectable before it is added to an agent workflow.

CC Switch main interface for managing multiple AI coding tools
The repository's CC Switch main interface for tool and provider settings.View repository image
02

Core capabilities

01

Switch model providers

Switch model providers is documented in the repository README or its component instructions. Review the linked source for current behavior and requirements.

02

Manage MCP configurations

Manage MCP configurations is documented in the repository README or its component instructions. Review the linked source for current behavior and requirements.

03

Sync prompts and skills

Sync prompts and skills is documented in the repository README or its component instructions. Review the linked source for current behavior and requirements.

04

Manage sessions and settings

Manage sessions and settings is documented in the repository README or its component instructions. Review the linked source for current behavior and requirements.

03

Installation and usage

Set up CC Switch from its public GitHub instructions, keep the initial permission scope small, and verify it with a low-risk task before regular use.

AI AGENT INSTALL

Let an AI Agent install it

Send this prompt to Codex, Claude Code, or another AI agent that can work with your local environment.

Help me set up CC Switch.
Project URL: https://github.com/farion1231/cc-switch

Read the repository README and license first. Confirm the current host, prerequisites, destination paths, and permissions. Follow the repository's documented method, keep credentials out of files and logs, and start with the least-privilege or read-only option where available. Afterward, run a small verification and report the exact changes, commands, configuration path, and result. Ask before overwriting files or requesting broader access.
01Before you start
  • Use Homebrew on macOS or download the matching Windows/Linux release
  • Back up current agent configuration before changes
02Copy the install command or configuration
brew install --cask cc-switch
03Complete the setup steps
  1. 1
    Review prerequisites and scope

    Read the README, confirm the target host, and prepare these prerequisites: Use Homebrew on macOS or download the matching Windows/Linux release; Back up current agent configuration before changes. Check destination paths and permissions before making changes.

  2. 2
    Apply the documented setup

    Run the documented command: brew install --cask cc-switch

  3. 3
    Verify with a small task

    Restart or reload the target agent, confirm that CC Switch appears in its installed extensions or skills, and run the smallest documented example before using it on important work.

How to verify the setup

Restart or reload the target agent, confirm that CC Switch appears in its installed extensions or skills, and run the smallest documented example before using it on important work.

Before using it
  • A central manager can access several configuration files and credentials
  • Host updates can require configuration-format adjustments
04

Use cases

SCENARIO 01

Switch between multiple AI coding tools

Switch between multiple AI coding tools is a practical fit when the repository's documented prerequisites and permission model match the current environment.

SCENARIO 02

Maintain MCP servers centrally

Maintain MCP servers centrally is a practical fit when the repository's documented prerequisites and permission model match the current environment.

SCENARIO 03

Manage multiple model provider configurations

Manage multiple model provider configurations is a practical fit when the repository's documented prerequisites and permission model match the current environment.

05

Assessment

This assessment is based on the repository README, component documentation, license, and maintenance metadata. Consolidates settings scattered across several tools; Supports major desktop platforms and multiple agents. The main trade-offs are also clear: A central manager can access several configuration files and credentials; Host updates can require configuration-format adjustments. No local installation or functional test was claimed during cataloging.

Why it may be useful

  • Consolidates settings scattered across several tools
  • Supports major desktop platforms and multiple agents

What to know first

  • A central manager can access several configuration files and credentials
  • Host updates can require configuration-format adjustments
06

README

CC Switch


Overview

A cross-platform desktop configuration manager for switching providers, MCP servers, prompts, and skills across Claude Code, Codex, Gemini CLI, and other tools. A cross-platform desktop configuration manager for switching providers, MCP servers, prompts, and skills across Claude Code, Codex, Gemini CLI, and other tools.

Getting started

  • Set up CC Switch from its public GitHub instructions, keep the initial permission scope small, and verify it with a low-risk task before regular use.
  • The repository describes CC Switch as a cross-platform desktop configuration manager for switching providers, MCP servers, prompts, and skills across Claude Code, Codex, Gemini CLI, and other tools.
  • Its main capabilities include switch model providers, manage mcp configurations, sync prompts and skills, manage sessions and settings. The documented facts include windows, macos, and linux, manages multiple ai coding tools, central mcp and skills management, desktop graphical interface.
  • Restart or reload the target agent, confirm that CC Switch appears in its installed extensions or skills, and run the smallest documented example before using it on important work.

Configuration

brew install --cask cc-switch
Read the complete README on GitHub