CC Switch CLI

CLI harness for CC Switch, a desktop app that manages AI coding tool (Claude Code, Codex, Gemini CLI, OpenCode, OpenClaw, Hermes) configurations. Built with Click and the CLI-Anything methodology.

Prerequisites

• Python 3.10+
• CC Switch installed with an active database at ~/.cc-switch/cc-switch.db

Installation

pip install -e .

After installation, the command cli-anything-ccswitch is available.

Command Groups

Group	Description
status	Show a quick database overview
providers	Manage AI provider configurations (list, get, set-current)
proxy	Manage the local HTTP proxy server (status, config)
mcp	Manage MCP (Model Context Protocol) servers (list, enable)
skills	Manage installed skills (list, repos)
usage	View API usage and cost statistics (stats, logs)
settings	View and manage CC Switch settings (list, get, set)
sessions	Browse and search AI conversation sessions (list)

Global Options

• --json, Output in machine-readable JSON format (recommended for agent use)
• --db PATH, Override the database path

Agent-Specific Guidance

JSON Output

Always use --json for programmatic consumption. Place it before the subcommand:

cli-anything-ccswitch --json providers list
cli-anything-ccswitch --json usage stats --days 30
cli-anything-ccswitch --json providers get <id> --app claude

Sensitive Values

API tokens, keys, and secrets are masked in all output. The settings_config field in provider details shows masked values (e.g., sk-bc089...5cbb).

Exit Codes

• 0, Success
• 1, Error (e.g., resource not found, invalid app type)

App Types

Valid app types: claude, codex, gemini, opencode, openclaw, hermes.

Examples

List all providers

cli-anything-ccswitch providers list
cli-anything-ccswitch --json providers list --app claude