# CC-Switch — Cross-Platform AI Agent Workspace Manager

> A desktop application that unifies account management for Claude Code, Codex, OpenCode, Gemini CLI, and other AI coding agents. Built with Tauri and Rust for speed and small binary size.

## Install

Save as a script file and run:

# CC-Switch — Cross-Platform AI Agent Workspace Manager

## Quick Use
```bash
# Download the latest release for your platform from GitHub
# macOS / Linux / Windows installers available
# Or build from source:
git clone https://github.com/farion1231/cc-switch.git
cd cc-switch
cargo tauri build
```

## 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

---
Source: https://tokrepo.com/en/workflows/asset-5ccf6077
Author: Script Depot