Справочник CLI
Справочник по локальному установщику и диагностическим командам. CLI спроектирован так, чтобы запускаться на машине оператора, идемпотентно применять bundle’ы и не изображать поддержку того, чего адаптер на самом деле не умеет.
Базовая архитектура
CLI vibebasket работает как идемпотентный локальный установщик. Когда ему передают bundle URL или локальный manifest-файл, он получает manifest, применяет только те возможности, которые реально поддерживает целевой адаптер, пропускает цели или MCP-записи, которые не может безопасно представить, создаёт backup известных конфигов перед реальным изменением и проверяет результат записи там, где поддерживается readback.
Доступные команды
vibebasket apply <url|file>Основная команда. Принимает hosted bundle URL или локальный JSON manifest-файл, валидирует manifest и применяет каждый элемент (MCP servers, skills, rules) ко всем совместимым локальным адаптерам. Адаптеры создают backup только тогда, когда действительно требуется мутация MCP-конфига, и выполняют merge идемпотентно, поэтому запускать apply дважды безопасно. Если цель не может корректно поддержать часть bundle, CLI честно помечает её как skipped, а не делает вид, что установка прошла успешно.
Текущий scope
apply остаётся основным путём установки. Также уже доступны вспомогательные команды list, search, doctor, init и rollback.
apply — Флаги
| Флаг | Тип | Описание |
|---|---|---|
| --force / -f | Boolean | Пропускает интерактивное подтверждение доверия и позволяет merge MCP в адаптере перезаписывать существующую запись MCP, если уже встречается тот же id. |
| --scope / -s | user | project | Переопределяет scope bundle’а. user устанавливает в домашнюю директорию, project — относительно текущей рабочей директории. |
| --dry-run / -d | Boolean | Показывает ожидаемые изменения конфигурации без записи на диск. Отображает конфигурацию цели, которая была бы применена. |
| --no-verify | Boolean | Пропускает post-install проверки readback. Полезно только для debugging или редких локальных сред, где readback временно ненадёжен. |
Другие команды
vibebasket list
Сканирует все 24 IDE-целей и показывает установленные MCP servers, skills и rules по каждой цели.
vibebasket search <query>
Ищет по каталогу VibeBasket из терминала через FTS5 full-text index. Возвращает до 10 совпадений из hosted каталога по MCP, Skills и Rules. Текущая terminal-поверхность намеренно лёгкая и больше подходит для быстрого discovery, чем для полного визуального просмотра.
vibebasket init
Создаёт структуру рабочей директории .vibebasket/ и локальный шаблон файла .vibebasket.env для project-scoped secret’ов и assets.
vibebasket doctor
Диагностирует локальную среду: проверяет структуру проекта .vibebasket, наличие конфигов адаптеров, при возможности считает MCP и печатает краткую сводку окружения для текущей машины.
vibebasket rollback
Открывает интерактивный restore flow, позволяет выбрать один из недавних backup’ов с timestamp и затем восстанавливает выбранный snapshot конфигурации адаптера. Для project-scoped backup’ов запускайте команду из того же корня проекта, который хотите восстановить.
vibebasket mcp serve
Запускает локальный stdio MCP-сервер VibeBasket. Это IDE-facing поверхность для поиска по каталогу, guidance по целям, планирования установки, apply bundle’ов, проверки backup’ов, rollback и локального сохранения/загрузки stack’ов. Cloud stack save по-прежнему намеренно оставлен за сайтом.