CC-Switch CLI

Command-line interface for CC Switch - the all-in-one manager for Claude Code, Codex, Gemini CLI, OpenCode & OpenClaw.

Installation

pip install cli-anything-cc-switch

Or install from source:

cd agent-harness
pip install -e .

Usage

# Show status
cli-anything-cc-switch status

# List providers
cli-anything-cc-switch provider list

# Set API key for a provider
cli-anything-cc-switch provider set-key claude YOUR_API_KEY

# Configure API URL
cli-anything-cc-switch provider set-url claude https://api.minimaxi.com/anthropic

# Test provider connectivity
cli-anything-cc-switch provider test claude

# Show all configuration
cli-anything-cc-switch config show

# Show specific provider config
cli-anything-cc-switch config show claude

# Manage sessions
cli-anything-cc-switch session list
cli-anything-cc-switch session create claude
cli-anything-cc-switch session show <session-id>
cli-anything-cc-switch session delete <session-id>

# Manage settings
cli-anything-cc-switch settings show
cli-anything-cc-switch settings set theme dark
cli-anything-cc-switch settings reset

# Export/Import settings
cli-anything-cc-switch settings export settings.json
cli-anything-cc-switch settings import settings.json

JSON Output

All commands support --json flag for machine-readable output:

cli-anything-cc-switch status --json
cli-anything-cc-switch provider list --json

Commands

Status

Shows current application status including installed state, active provider, and configured providers.

cli-anything-cc-switch status

Provider Management

# List all providers
cli-anything-cc-switch provider list

# Show provider info
cli-anything-cc-switch provider info claude

# Set API key
cli-anything-cc-switch provider set-key claude YOUR_API_KEY

# Set API URL
cli-anything-cc-switch provider set-url claude https://custom.api.url

# Test connectivity
cli-anything-cc-switch provider test claude

Configuration

# Show all config
cli-anything-cc-switch config show

# Show specific provider config
cli-anything-cc-switch config show claude

# Set config values
cli-anything-cc-switch config set claude --api-key=KEY --model=claude-opus-4-6

Session Management

# List sessions
cli-anything-cc-switch session list

# Create session
cli-anything-cc-switch session create claude

# Show session details
cli-anything-cc-switch session show <session-id>

# Delete session
cli-anything-cc-switch session delete <session-id>

# Cleanup old sessions
cli-anything-cc-switch session cleanup --days 30

Settings

# Show settings
cli-anything-cc-switch settings show

# Set a setting
cli-anything-cc-switch settings set auto_save false
cli-anything-cc-switch settings set theme dark

# Reset to defaults
cli-anything-cc-switch settings reset

# Export/Import
cli-anything-cc-switch settings export backup.json
cli-anything-cc-switch settings import backup.json

Supported Providers

Provider	Description
claude	Anthropic's Claude AI
codex	OpenAI's Codex
gemini	Google's Gemini
opencode	OpenCode platform
openclaw	OpenClaw tool

Configuration File

Default location: ~/.cc-switch/config.json

Session Directory

Default location: ~/.cc-switch/sessions/

Requirements

• Python 3.10+
• click >= 8.0.0

License

MIT License