cli-anything-ccswitch — Claude Code skill: install and use
The cli-anything-ccswitch skill gives an agent terminal access to CC Switch settings, including providers, proxy state, MCP servers, skills, sessions, and usage data.
Apache-2.0 272 installs ★ 62,125 updated 2026-09-22
npx skills add HKUDS/CLI-Anything --skill cli-anything-ccswitch -a claude-codeWhat cli-anything-ccswitch does
The skill exposes CC Switch through the cli-anything-ccswitch command. An agent can inspect the database, list or switch providers, check the local HTTP proxy, manage MCP servers, and browse installed skills.
It also covers API usage statistics, logs, settings, and AI conversation sessions. Put --json before a subcommand for machine-readable output, or use --db PATH to point at another database. Secrets and API keys are masked in command output.
The setup requires Python 3.10+ and an installed CC Switch instance with an active database at ~/.cc-switch/cc-switch.db. Read commands leave the database unchanged, while provider switching, proxy configuration, MCP enabling, and settings changes write to it directly.
What it helps with
- list configured AI providers
- switch the active provider for an app
- inspect the local proxy status
- enable an MCP server for
claude - review usage logs and conversation sessions
Example prompts for the agent
- Use
cli-anything-ccswitchto listclaudeproviders as JSON. - Check the proxy status for
claudeand report the result. - Show the latest
claudesessions with a limit of10.
How to install cli-anything-ccswitch
1Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-ccswitch -a claude-code2Manually: put the files in place
~/.claude/skills/cli-anything-ccswitch/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/cli-anything-ccswitch/
1Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-ccswitch -a codex2Manually: put the files in place
.agents/skills/cli-anything-ccswitch/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-ccswitch -a cursor2Manually: put the files in place
.cursor/skills/cli-anything-ccswitch/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install HKUDS/CLI-Anything skills/cli-anything-ccswitch2Manually: put the files in place
.github/skills/cli-anything-ccswitch/SKILL.md1Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-ccswitch -a gemini-cli2Platform CLI
gemini skills install https://github.com/HKUDS/CLI-Anything --path skills/cli-anything-ccswitchManually: put the files in place
.devin/skills/cli-anything-ccswitch/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add HKUDS/CLI-Anything --skill cli-anything-ccswitch -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about cli-anything-ccswitch
How do I install cli-anything-ccswitch in Claude Code?
Run npx skills add HKUDS/CLI-Anything --skill cli-anything-ccswitch -a claude-code, then use ~/.claude/skills/cli-anything-ccswitch/SKILL.md.
What does cli-anything-ccswitch do?
It gives an agent a CLI for CC Switch, covering providers, proxy settings, MCP servers, installed skills, usage data, settings, and sessions.
What does cli-anything-ccswitch require?
You need Python 3.10+ and CC Switch with an active database at ~/.cc-switch/cc-switch.db. Install the CLI with pip install -e ..
Source text
SKILL.md · Apache-2.0
--- name: "cli-anything-ccswitch" description: "CLI interface for CC Switch — manage AI coding tool configurations from the terminal" --- # 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 ```bash 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: ```bash 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 ```bash cli-anything-ccswitch providers list cli-anything-ccswitch --json providers list --app claude ``` ### Switch active provider ```bash cli-anything-ccswitch providers set-current <provider-id> --app claude ``` ### Check proxy status ```bash cli-anything-ccswitch proxy status --app claude cli-anything-ccswitch proxy config --app claude --set-port 8080 ``` ### View usage stats ```bash cli-anything-ccswitch usage stats --days 7 cli-anything-ccswitch --json usage stats --days 30 --app claude cli-anything-ccswitch usage logs --limit 10 ``` ### List skills ```bash cli-anything-ccswitch skills list cli-anything-ccswitch skills repos ``` ### MCP servers ```bash cli-anything-ccswitch mcp list cli-anything-ccswitch mcp enable <server-id> --app claude --on ``` ### Settings ```bash cli-anything-ccswitch settings list cli-anything-ccswitch settings get <key> cli-anything-ccswitch settings set <key> <value> ``` ### Sessions ```bash cli-anything-ccswitch sessions list --app claude --limit 10 ``` ### Status overview ```bash cli-anything-ccswitch status cli-anything-ccswitch cli-anything-ccswitch --json ``` ## 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.
© HKUDS · Apache-2.0 · HKUDS/CLI-Anything