内容
# cli-switch
在多个 AI 命令行界面（CLI）中保持 **MCP 服务器、技能和指令** 的同步 — 自动。
支持：**Claude Code · Codex · opencode · Kiro · Antigravity CLI (`agy`) · GitHub Copilot CLI (`copilot`)**
---
## 问题
您在多个 AI CLI 中分别管理 MCP 服务器、技能和指令文件，但它们具有不兼容的格式。`cli-switch` 提供了一个单一的编辑位置，并将所有内容同步到各个 CLI。
---
## 安装
```bash
git clone https://github.com/fdsf53451001/cli-switch && cd cli-switch
./install.sh
```
预编译的 macOS (Apple Silicon / Intel)、Linux x86_64 和 Windows x86_64 二进制文件。不需要 Rust。
---
## 快速入门
```bash
cli-switch
```
这将打开交互式菜单。按照步骤：
1. **设置 CLI** — 选择您使用的 CLI
2. **设置全局级别** — 为用户级配置启用同步
3. **设置项目级别** — 为当前项目目录启用同步
就是这样。编辑 `~/.config/cli-switch/mcp.json`、`AGENTS.md` 或 `skills/` 一次 — `cli-switch sync` 将更改传播到所有 CLI。
---
## 命令
```bash
cli-switch # 交互式菜单
cli-switch sync # 立即同步
cli-switch status # 检查所有 CLI 的同步状态
cli-switch mount # 将 cli-switch 挂接到每个 CLI 的启动中
```
---
## 工作原理
- **MCP 服务器** — 在 `~/.config/cli-switch/mcp.json` 中编辑一次；同步时转换为每个 CLI 的本地格式
- **指令** — 一个 `AGENTS.md` 作为 `CLAUDE.md`、`copilot-instructions.md` 等符号链接
- **技能** — 一个 `skills/` 文件夹符号链接到每个 CLI
- **双向** — 在任何 CLI 中进行的更改将在下一次同步时合并回去
### 项目级同步
在项目目录中运行 `cli-switch` 并选择 **设置项目级别** 以在 CLI 之间同步该项目的指令和技能。使用 `AGENTS.md` 和 `.agents/skills/` 作为共享源。
### 启动时自动同步
运行 `cli-switch mount` 将 `cli-switch sync` 挂接到每个 CLI 的启动中 — 这样所有内容都保持同步，无需手动运行。
---
## 真相来源
所有内容都存放在 `~/.config/cli-switch/`：
```
mcp.json # 您的 MCP 服务器（编辑此文件）
AGENTS.md # 您的共享指令（编辑此文件）
skills/ # 您的共享技能（编辑此文件）
config.toml # 哪些 CLI 和作用域是活动的
```
