ccs-plus

cc-switch provider manager · multi-agent CLI launcher · fullscreen TUI
_{Claude · Codex · Gemini · Grok · OpenCode — one command, one pane, zero context switching}

_{Interactive launcher — app badges, provider picker, directory-scoped sessions, per-app permission presets}

ccs-plus 管理 cc-switch SQLite 中的 Claude、Codex、Gemini、Grok、OpenCode provider，并用选定 provider 启动对应原生 CLI。只做 provider 管理、运行配置和启动，不实现 GUI、本地代理或请求转换。

安装

从 GitHub Release 下载二进制（推荐）或 .whl。开发安装用 make deps && make install。本机还需要已安装的 CLI（claude / codex / gemini / grok / opencode）和可访问的 cc-switch 数据库。ccs-plus 与 ccsp 是同一入口。

uv tool install ./ccs_plus-x.y.z-py3-none-any.whl   # wheel，需 Python 3.12+
cp .env.example .env                                 # 填入 Fernet key

使用

无参进入 TUI。二进制把下面的 ccsp 换成 ccs-plus。完整参数看 ccsp --help；provider / launch / run 可简写为 p / l / r。

TUI

顶栏 cwd 是启动时的当前目录，TUI 内不能改。Resume 使用会话自身的 cwd；sessions 面板按 a 可在「当前目录 / 全部项目」之间切换。

启动

ccsp
ccsp run x2
ccsp run m1
ccsp run o1
ccsp launch codex --provider "<provider-name>"
ccsp launch opencode --provider "<provider-name>" --cwd "<directory>"

run 使用 provider list 里的编号（c1 / x2 / m1 / g1 / o1）。launch --cwd 指定工作目录；--model 和 --effort 只覆盖本次启动。

管理 provider

ccsp provider list
ccsp provider list --app claude
ccsp provider show "<provider-name>"
ccsp provider add claude --name "<provider-name>" --endpoint "https://api.example.com/v1" --api-key "<api-key>" --model "<model-id>"
ccsp provider add opencode --name "<provider-name>" --endpoint "https://api.example.com/v1" --api-key "<api-key>" --model "provider-id/model-id"

list 的 Alias 按 app 分组编号。show 会打印可复用的 provider add 命令，默认把 API Key 打成 xxxx；只有在可信终端才用 --show-secret。同一 app 内名称唯一，大小写不敏感。

备份与清理

ccsp provider export
ccsp provider import "data/providers-all-<timestamp>.json"
ccsp provider reset
ccsp provider delete claude "<provider-name>" --yes

export / import / reset 省略 app 时覆盖 Claude、Codex、Gemini、Grok、OpenCode；后面跟 app 名则只处理一个。未指定路径时，备份写到 data/providers-all-<timestamp>.json。恢复必须使用生成备份时的同一个 encryption_key。reset 默认只预览，加 --yes 才删除非官方 provider。

开发

make check / make test。推送 v* tag 会先发 wheel，再把各平台二进制挂到同一 Release。