CLI 参考
这里汇总本地安装与检查命令。CLI 设计为在操作者自己的机器上运行，以幂等方式 apply bundles，并且不会假装 adapter 支持它实际上并未实现的能力。
核心架构
vibebasket CLI 充当一个幂等的本地安装器。当传入 bundle URL 或本地 manifest 文件时，它会获取并验证 manifest，只应用目标 adapter 真正支持的能力，跳过无法安全表达的目标或 MCP 条目，在确实需要修改已知配置文件时先写入备份，并在目标实现了 readback 时验证写入结果。
可用命令
vibebasket apply <url|file>这是主命令。它接受托管的 bundle URL 或本地 JSON manifest 文件，验证 manifest，然后将每个条目（MCP servers、skills、rules）应用到所有兼容的本地 adapters。只有在确实需要更改 MCP 配置时，adapter 才会为已有配置文件创建备份，并以幂等方式合并条目，因此多次运行 apply 是安全的。如果某个目标无法干净地支持 bundle 的某一部分，CLI 会把该目标报告为 skipped，而不是假装安装成功。
当前范围
apply 仍然是主要安装路径。现在也提供 list、search、doctor、init 和 rollback 等辅助命令。
apply — 参数
| 参数 | 类型 | 说明 |
|---|---|---|
| --force / -f | Boolean | 跳过交互式信任确认，并允许 adapter 的 MCP 合并在相同 id 已存在时覆盖现有 MCP 条目。 |
| --scope / -s | user | project | 覆盖 bundle 的范围。user 安装到主目录，project 安装到当前工作目录。 |
| --dry-run / -d | Boolean | 预览即将发生的配置变更而不写入磁盘。显示将要应用的目标配置。 |
| --no-verify | Boolean | 跳过安装后的 readback 检查。只适用于调试或某些 readback 暂时不可靠的特殊本地环境。 |
其他命令
vibebasket list
扫描全部 24 个 IDE 目标，并按目标报告已安装的 MCP servers、skills 和 rules。
vibebasket search <query>
在终端中使用 FTS5 全文索引搜索 VibeBasket 目录。从托管目录中的 MCP、Skills 和 Rules 里返回最多 10 个匹配项。当前终端界面刻意保持轻量，更适合快速发现，而不是完整的可视化浏览。
vibebasket init
生成 .vibebasket/ 工作区结构，以及一个供项目范围 secret 和资源使用的本地 .vibebasket.env 模板文件。
vibebasket doctor
诊断本地环境：检查 .vibebasket 项目结构，探测 adapter 配置是否存在，在可读取时报告 MCP 数量，并输出当前机器的简明环境摘要。
vibebasket rollback
打开交互式恢复流程，让你从最近带时间戳的备份中进行选择，然后恢复选定的 adapter 配置快照。对于 project 范围的备份，请从你想恢复的同一个项目根目录中运行它。
vibebasket mcp serve
运行本地 stdio VibeBasket MCP 服务。这是面向 IDE 的入口，用于目录搜索、目标指导、安装规划、bundle apply、备份检查、rollback，以及本地 stack 的保存与加载。Cloud stack save 目前仍刻意保留在网站路径中。