CC-Switch — Cross-Platform AI Agent Workspace Manager

Introduction

CC-Switch is a cross-platform desktop application that provides a single interface for managing multiple AI coding agent accounts and configurations. Instead of juggling separate terminals and credentials for each AI tool, CC-Switch consolidates them into one workspace with quick switching and quota monitoring.

What CC-Switch Does

• Manages multiple accounts across Claude Code, Codex, OpenCode, Gemini CLI, and Hermes Agent
• Provides one-click account switching without re-authenticating each tool
• Monitors API quota usage and remaining limits per account
• Supports multi-instance management for running parallel agent sessions
• Offers WSL integration for Windows users running Linux-based agents

Architecture Overview

CC-Switch is built with Tauri v2 on the backend (Rust) and React with TypeScript on the frontend. The Rust layer handles credential storage, process management, and system-level integrations. Configuration files are stored locally, and no data is sent to external servers beyond the agent providers themselves.

Self-Hosting & Configuration

• Download pre-built binaries from the GitHub releases page for macOS, Linux, or Windows
• Build from source using Rust toolchain and Node.js for the frontend
• Configure each agent provider by adding API keys or OAuth tokens in the settings panel
• Adjust quota thresholds and alert preferences per account
• WSL mode can be toggled in settings for Windows environments

Key Features

• Unified dashboard for all supported AI coding agents
• Instant account switching preserving session state
• Real-time quota and usage monitoring across providers
• Built with Tauri v2 for a small, fast native binary
• Extensible provider system for adding new agent tools

Comparison with Similar Tools

• Manual terminal switching — requires separate shells and credential management per tool
• Shell aliases / scripts — fragile, no GUI, no quota visibility
• Antigravity Manager — similar concept but narrower provider support
• Native provider UIs — each tool has its own settings; CC-Switch unifies them

FAQ

Q: Does CC-Switch store my API keys securely? A: Yes, credentials are stored using the operating system's native keychain (macOS Keychain, Windows Credential Manager, or Linux Secret Service).

Q: Which AI coding agents are supported? A: Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI, and Hermes Agent. The provider list is extensible.

Q: Does it work on Linux? A: Yes. Pre-built AppImage and .deb packages are available, and you can build from source on any Linux distribution.

Q: Is an internet connection required? A: Only for communicating with the AI agent providers. CC-Switch itself runs entirely locally.

Sources

• https://github.com/farion1231/cc-switch
• https://ccswitch.io