Referencia CLI
Referencia de los comandos locales de instalación e inspección. El CLI está diseñado para ejecutarse en la máquina del operador, aplicar bundles de forma idempotente y no fingir soporte que un adaptador no implementa realmente.
Arquitectura principal
El CLI de vibebasket funciona como un instalador local idempotente. Cuando recibe una URL de bundle o un archivo de manifiesto local, obtiene el manifiesto, aplica solo las capacidades que el adaptador de destino realmente soporta, omite objetivos o entradas MCP que no puede representar con seguridad, escribe backups antes de mutar archivos de configuración conocidos cuando hace falta un cambio real y verifica el resultado escrito cuando el adaptador implementa readback.
Comandos disponibles
vibebasket apply <url|file>Es el comando principal. Acepta una URL de bundle alojada o un archivo local de manifiesto JSON, valida el manifiesto y aplica cada elemento (servidores MCP, skills y rules) a todos los adaptadores locales compatibles. Los adaptadores solo crean backup de archivos de configuración existentes cuando de verdad hace falta mutar la configuración MCP y hacen merge de forma idempotente, así que ejecutar apply dos veces es seguro. Si un objetivo no puede soportar parte del bundle limpiamente, el CLI lo informa como omitido en lugar de fingir que la instalación tuvo éxito.
Alcance actual
apply sigue siendo la ruta principal de instalación. Hoy también están disponibles comandos de apoyo como list, search, doctor, init y rollback.
apply — Opciones
| Opción | Tipo | Descripción |
|---|---|---|
| --force / -f | Boolean | Omite la confirmación interactiva de confianza y permite que los merges MCP del adaptador sobrescriban una entrada MCP existente cuando ya está presente el mismo id. |
| --scope / -s | user | project | Sobrescribe el alcance del bundle. user instala en el directorio personal y project instala relativo al directorio de trabajo. |
| --dry-run / -d | Boolean | Previsualiza los cambios de configuración pendientes sin escribir en disco. Muestra la configuración de destino que se aplicaría. |
| --no-verify | Boolean | Omite las comprobaciones de lectura posteriores a la instalación. Solo es útil para depuración o entornos locales poco habituales donde el readback sea temporalmente poco fiable. |
Otros comandos
vibebasket list
Escanea los 24 objetivos IDE y reporta los MCP servers, skills y rules instalados por objetivo.
vibebasket search <query>
Busca el catálogo de VibeBasket desde la terminal usando el índice FTS5 de texto completo. Devuelve hasta 10 coincidencias del catálogo alojado entre MCPs, Skills y Rules. La superficie actual de terminal es intencionalmente ligera y está pensada más para descubrimiento rápido que para navegación visual completa.
vibebasket init
Genera una estructura de espacio de trabajo .vibebasket/ junto con una plantilla local de archivo .vibebasket.env para secretos y assets con alcance de proyecto.
vibebasket doctor
Diagnostica el entorno local: comprueba la estructura del proyecto .vibebasket, inspecciona la presencia de configuración del adaptador, informa cantidades MCP cuando son legibles y muestra un resumen conciso del entorno de la máquina actual.
vibebasket rollback
Abre un flujo interactivo de restauración, te permite elegir entre backups recientes con marca temporal y luego restaura la instantánea de configuración del adaptador seleccionada. Para backups con alcance de proyecto, ejecútalo desde la misma raíz de proyecto que quieras restaurar.
vibebasket mcp serve
Ejecuta el servidor MCP local de VibeBasket sobre stdio. Es la superficie orientada al IDE para búsqueda de catálogo, guía de objetivos, planificación de instalación, apply de bundles, inspección de backups, rollback y guardado/carga de stacks locales. El guardado cloud de stacks sigue pasando por el sitio web por diseño.