Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add HKUDS/CLI-Anything --skill cli-anything-ccswitch -a claude-code
Open on GitHub

What 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-ccswitch to list claude providers as JSON.
  • Check the proxy status for claude and report the result.
  • Show the latest claude sessions with a limit of 10.

How to install cli-anything-ccswitch

1Skills CLI (Vercel)

npx skills add HKUDS/CLI-Anything --skill cli-anything-ccswitch -a claude-code

2Manually: put the files in place

~/.claude/skills/cli-anything-ccswitch/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/cli-anything-ccswitch/

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

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set69

The whole set →
cli-anything-minimax The cli-anything-minimax skill gives coding agents a MiniMax CLI for chat, streamed responses, and speech synthesis through the MiniMax API. CX Codex +1 350installs cli-anything-hermes cli-anything-hermes — a Hermes agent skill that builds CLI wrappers over graphical applications and repositories. Wraps any software into a command-line interface with stateful sessions, undo/redo, and JSON output. CX Codex +1 314installs cli-anything-live2d cli-anything-live2d provides 42 terminal commands to inspect, edit, lint, and deploy Live2D Cubism models without running Live2D Editor. CX Codex +1 299installs cli-anything-joplin cli-anything-joplin is a Claude Code skill that manages Joplin notes, notebooks, to-dos and tags through the terminal backend. The agent exports data and syncs the project without opening the GUI. CX Codex +1 299installs cli-anything-eez-studio cli-anything-eez-studio is a Claude Code skill that gives agents CLI access to EEZ Studio for editing .eez-project files, placing LVGL widgets, and building SCPI command trees. CX Codex +1 266installs cli-anything-wavetone cli-anything-wavetone prepares JSON manifests and opens WaveTone 2.61 for audio transcription. Built for agents handling tempo settings, labels, and audio checks on Windows. CX Codex +1 265installs cli-anything-jumpserver The cli-anything-jumpserver skill gives agents a CLI for JumpServer administration through its REST API, including assets, users, permissions, accounts, sessions, and audit data. CX Codex +1 258installs cli-anything-siyuan The cli-anything-siyuan skill gives an agent CLI access to SiYuan for notebook, document, and block management, full-text search, SQL queries, and Markdown export. CX Codex +1 255installs

Project sponsors

Companies that keep this analytics open