Summary

CC-Switch CLI offers a unified command-line interface for managing configurations across Claude Code, Codex, and Gemini AI assistants. It targets developers seeking to streamline their workflow by centralizing API keys, server settings, and system prompts for multiple AI providers, enhancing productivity and simplifying complex setups.

How It Works

Built with Rust, CC-Switch CLI employs a Single Source of Truth (SSOT) architecture, storing all primary configurations in ~/.cc-switch/config.json. It utilizes atomic writes for robust configuration file management and generates live configurations for each supported AI service. The tool supports various transport types for Model Context Protocol (MCP) servers and reuses core logic from its GUI predecessor, ensuring a stable foundation.

Quick Start & Requirements

The recommended installation method is downloading pre-built binaries from GitHub Releases for macOS, Linux (x64/ARM64), or Windows. Alternatively, users can build from source, requiring Rust 1.85+ installed via rustup. Installation involves downloading archives, extracting, granting execute permissions, and moving the binary to a system PATH directory. Detailed commands are provided for each OS.

Highlighted Details

• Comprehensive provider management, including one-click switching, multi-endpoint support, API key handling, and latency testing.
• Unified MCP server management with multi-app support, automatic synchronization, and flexible transport options (stdio, http, sse).
• System prompt management for Claude, Codex, and Gemini, allowing activation and deactivation of presets.
• Robust configuration backup, import, export, and reset functionalities.
• Cross-platform compatibility across Windows, macOS, and Linux.

Maintenance & Community

The project is a CLI fork maintained by "saladday," with original architecture from "farion1231/cc-switch." Bug reports and feature requests should be filed via GitHub Issues. Specific community channels like Discord or Slack are not mentioned.

Licensing & Compatibility

CC-Switch CLI is released under the MIT License. This permissive license generally allows for commercial use and integration into closed-source projects without significant restrictions.

Limitations & Caveats

The "Skills Management" feature is currently not implemented but is planned for future releases. Users may encounter configuration conflicts if AI provider API keys are set as system environment variables, requiring manual intervention to remove them from shell configuration files.