Manage AI coding tool configurations through CC Switch from the terminal. Switch active providers, adjust settings, enable MCP servers that connect agents to external tools, and inspect API usage, costs, installed skills, and conversation sessions.
CLI interface for CC Switch — manage AI coding tool configurations from the terminal
Review the instructions the agent will receive before you install.
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.
~/.cc-switch/cc-switch.dbpip install -e .
After installation, the command cli-anything-ccswitch is available.
| 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) |
--json — Output in machine-readable JSON format (recommended for agent use)--db PATH — Override the database pathAlways 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
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).
0 — Success1 — Error (e.g., resource not found, invalid app type)Valid app types: claude, codex, gemini, opencode, openclaw, hermes.
cli-anything-ccswitch providers list
cli-anything-ccswitch --json providers list --app claude
cli-anything-ccswitch providers set-current <provider-id> --app claude
cli-anything-ccswitch proxy status --app claude
cli-anything-ccswitch proxy config --app claude --set-port 8080
cli-anything-ccswitch usage stats --days 7
cli-anything-ccswitch --json usage stats --days 30 --app claude
cli-anything-ccswitch usage logs --limit 10
cli-anything-ccswitch skills list
cli-anything-ccswitch skills repos
cli-anything-ccswitch mcp list
cli-anything-ccswitch mcp enable <server-id> --app claude --on
cli-anything-ccswitch settings list
cli-anything-ccswitch settings get <key>
cli-anything-ccswitch settings set <key> <value>
cli-anything-ccswitch sessions list --app claude --limit 10
cli-anything-ccswitch status
cli-anything-ccswitch
cli-anything-ccswitch --json
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.
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.
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Use Reasonix to build or improve a Python command-line interface for existing software. The workflow covers source analysis, interactive commands, JSON output, tests, documentation, and installation checks using the software’s own backend where possible.
Build and improve Python command interfaces for GUI applications with OpenClaw. The skill guides source analysis, command design, testing, and packaging, including interactive sessions and structured JSON output for agents.
Use Codex to build Python command-line tools for applications with graphical interfaces. Analyze source code, add commands, test against the actual software, validate packaging and documentation, and discover tools already generated or installed.
Inspect and edit 3MF files for 3D printing. Detect cylindrical holes, change their diameters, repair mesh issues, and compare files while preserving BambuStudio and PrusaSlicer metadata when repacking the edited file.
Manage AdGuard Home network filtering from the command line. Update blocklists, register devices, configure DNS rules that map names to addresses, and inspect query logs and statistics through the AdGuard Home REST API.
Generate slides, documents, websites, and diagrams from natural language prompts through AnyGen OpenAPI. Manage reference uploads, check generation progress, and download finished files using commands with structured output for AI agents.