# CLI Anything Ccswitch

CLI interface for CC Switch, manage AI coding tool configurations from the terminal

- Repository: https://github.com/HKUDS/CLI-Anything (58029 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-09-22
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add HKUDS/CLI-Anything --skill cli-anything-ccswitch -g -a claude-code -y`
Codex: `npx skills add HKUDS/CLI-Anything --skill cli-anything-ccswitch -g -a codex -y`
Cursor: `npx skills add HKUDS/CLI-Anything --skill cli-anything-ccswitch -g -a cursor -y`
Gemini CLI: `npx skills add HKUDS/CLI-Anything --skill cli-anything-ccswitch -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add HKUDS/CLI-Anything`

## Description

CLI interface for CC Switch, manage AI coding tool configurations from the terminal

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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
```

The rest: https://github.com/HKUDS/CLI-Anything/blob/HEAD/cc-switch/agent-harness/cli_anything/ccswitch/skills/SKILL.md