cli-anything-ccswitch

CC Switch CLI

CC Switch の CLI ハーネスです。CC Switch は、AI コーディングツール(Claude Code、 Codex、Gemini CLI、OpenCode、OpenClaw、Hermes)の設定を管理するデスクトップアプリです。Click と CLI-Anything メソッド論を用いて構築されています。

前提条件

• Python 3.10 以上
• ~/.cc-switch/cc-switch.db にアクティブなデータベースを持つ CC Switch がインストールされていること

インストール

pip install -e .

インストール後、cli-anything-ccswitch コマンドが利用可能になります。

コマンドグループ

グループ	説明
status	データベースの概要をすばやく表示します
providers	AI プロバイダーの設定を管理します(list、get、set-current)
proxy	ローカル HTTP プロキシサーバーを管理します(status、config)
mcp	MCP(Model Context Protocol)サーバーを管理します(list、enable)
skills	インストール済みのスキルを管理します(list、repos)
usage	API の使用状況とコストの統計を表示します(stats、logs)
settings	CC Switch の設定を表示・管理します(list、get、set)
sessions	AI の会話セッションを閲覧・検索します(list)

グローバルオプション

• --json — 機械可読な JSON 形式で出力します(エージェントでの使用を推奨)
• --db PATH — データベースのパスを上書きします

エージェント向けのガイダンス

JSON 出力

プログラムで利用する場合は常に --json を使用してください。サブコマンドの 前に指定します:

cli-anything-ccswitch --json providers list
cli-anything-ccswitch --json usage stats --days 30
cli-anything-ccswitch --json providers get <id> --app claude

機密値

API トークン、キー、シークレットはすべての出力でマスクされます。プロバイダーの詳細にある settings_config フィールドにはマスクされた値(例: sk-bc089...5cbb)が表示されます。

終了コード

• 0 — 成功
• 1 — エラー(例: リソースが見つからない、無効なアプリタイプ)

アプリタイプ

有効なアプリタイプ: 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

MCP サーバー

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

エラー処理

リソースが見つからない場合、CLI は stderr にエラーメッセージを出力し、 終了コード 1 で終了します。エージェントは出力を解析する前に終了コードを確認する必要があります。

データベース

CLI は稼働中の CC Switch SQLite データベースから読み取ります。すべての読み取り操作 は安全であり、データベースを変更しません。書き込み操作(providers set-current、proxy config、mcp enable、settings set)は データベースを直接変更します。