将 MCP、Skill、Prompt 配置在多台机器之间同步的 CLI 工具,支持 Claude、Codex、Gemini、OpenCode。
ccs 适合这些场景:
- 新电脑初始化时快速恢复 AI 客户端配置
- 在工作机、个人机、远程机之间同步常用配置
- 把 MCP、提示词、Skill 元数据统一存放到 Gist、WebDAV 或本地文件
- 同步三类配置:MCP、Prompt、Skill 元数据
- 支持三种后端:GitHub Gist、WebDAV、本地文件
- 支持交互式选择与预览,避免误覆盖
- 支持
--only精确同步mcp、prompt、skill - 单文件二进制分发,适合直接下载使用
Important
Skill 目前只同步元数据,不同步实际文件内容。
如果目标机器缺少对应 Skill,ccs sync 会提示你手动安装。
安装最新版本:
curl -fsSL https://sh.snailuu.cn/ccs/install.sh | bash指定安装目录:
curl -fsSL https://sh.snailuu.cn/ccs/install.sh | CCS_INSTALL_DIR="$HOME/.local/bin" bash最新版本下载地址:
- macOS Apple Silicon: ccs-darwin-arm64
- macOS Intel: ccs-darwin-x64
- Linux x64: ccs-linux-x64
- Linux ARM64: ccs-linux-arm64
- Windows x64: ccs-windows-x64.exe
示例:
curl -fsSL -o ccs https://sh.snailuu.cn/ccs/latest/ccs-darwin-arm64
chmod +x ccs
mv ccs "$HOME/.local/bin/ccs"如果当前 ccs 是通过 sh.snailuu.cn 安装的单文件二进制,可以直接执行:
ccs updateNote
ccs update 只支持通过 sh.snailuu.cn 安装的单文件二进制版本,
不支持 bun run、源码运行或其他安装方式。
推荐先用交互式向导:
ccs config也可以直接通过命令设置。
GitHub Gist:
ccs config set backend gist
ccs config set gist.token ghp_xxxxxWebDAV:
ccs config set backend webdav
ccs config set webdav.url https://your-webdav-server.com/dav
ccs config set webdav.username youruser
ccs config set webdav.password yourpass本地文件:
ccs config set backend local
ccs config set local.path ~/Dropbox/ccs-bundle.jsonccs push只推送部分内容:
ccs push --only mcp,prompt预览但不上传:
ccs push --dry-runccs diff
ccs syncNote
sync 是实际的拉取并写入命令。它会先从云端读取 bundle,再让你选择同步类型、条目和目标客户端。
| 命令 | 说明 |
|---|---|
ccs push |
采集本机配置并上传到云端 |
ccs sync |
从云端拉取并应用配置到目标客户端 |
ccs status |
显示本机当前配置摘要 |
ccs diff |
预览本机与云端配置差异 |
ccs config |
启动交互式配置向导 |
ccs config show |
显示当前后端配置 |
ccs config set <key> <value> |
通过脚本方式设置配置项 |
ccs update |
检测最新版本并在确认后更新当前二进制 |
常用选项:
| 选项 | 说明 |
|---|---|
--help, -h |
显示帮助 |
--version, -v |
显示版本 |
--only mcp,skill,prompt |
只操作指定类型,适用于 push 和 sync |
--dry-run |
仅预览,不实际上传,适用于 push |
读取这些客户端中的 MCP 配置:
- Claude:
~/.claude.json - Codex:
~/.codex/config.toml - Gemini:
~/.gemini/settings.json - OpenCode:
~/.config/opencode/opencode.json
读取这些提示词文件:
- Claude:
~/.claude/CLAUDE.md - Codex:
~/.codex/AGENTS.md - Gemini:
~/.gemini/GEMINI.md - OpenCode:
~/.config/opencode/AGENTS.md
同步内容包括:
- Skill 目录名
SKILL.md中解析出的名称和描述- 仓库来源信息
- 在哪些客户端中启用
不包含:
- Skill 目录内的实际文件
- 仓库克隆内容
- 运行时生成的缓存
- 默认安装脚本: install.sh
- Latest 安装脚本: latest/install.sh
| 平台 | 地址 |
|---|---|
| macOS Apple Silicon | ccs-darwin-arm64 |
| macOS Intel | ccs-darwin-x64 |
| Linux x64 | ccs-linux-x64 |
| Linux ARM64 | ccs-linux-arm64 |
| Windows x64 | ccs-windows-x64.exe |
云端存储的 bundle 会缓存到本地 ~/.ccs/bundle.json,结构如下:
{
"version": "1",
"pushedAt": "2026-03-23T10:00:00.000Z",
"hostname": "my-macbook",
"mcp": [],
"prompts": [],
"skills": []
}配置文件位于 ~/.ccs/config.json。