cli-anything-ccswitch

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

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

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

Switch active provider

Check proxy status

View usage stats

List skills

MCP servers

Settings

Sessions

Status overview

Error Handling

When a resource is not found, the CLI prints an error message to stderr and exits with code 1. Agents should check the exit code before parsing output.

Database

The CLI reads from the live CC Switch SQLite database. All read operations are safe and do not modify the database. Write operations (providers set-current, proxy config, mcp enable, settings set) modify the database directly.