Ejecutar comandos de shell
En esta página
Una shell completa dentro de la sesión
Vibe incluye un terminal Bash con estado. La palabra clave es con estado: el entorno persiste de un comando al siguiente. Esto significa que las variables de entorno que exportas, el directorio de trabajo actual al que navegas y los alias que defines permanecen activos para los comandos posteriores. No empiezas desde cero en cada llamada, a diferencia de las herramientas que lanzan una subshell desechable.
El agente utiliza este terminal siempre que lo necesita: para ejecutar pruebas, comprobar el estado o instalar una dependencia, pero tú también tienes libertad para invocar comandos por tu cuenta.
El prefijo ! para ejecución directa
Cuando sabes exactamente qué quieres ejecutar, la vía más rápida es el prefijo !:
!ls -la src/
!git log --oneline -10
!npm run test -- --watch
Este ! le indica a Vibe que todo lo que sigue es un comando de shell que debe ejecutarse tal cual, sin interpretación del agente. La salida aparece de inmediato y permaneces en modo interactivo.
La alternativa es dejar que el agente traduzca tu intención. Pídele que ejecute pruebas unitarias, instale la dependencia axios o verifique que el servidor de desarrollo se inicia correctamente. Él determinará el comando adecuado para tu proyecto —npm, pip, cargo— y lo propondrá para tu aprobación. Este es el enfoque preferido cuando exploras un proyecto cuyas convenciones de herramientas aún no conoces.
Aprobación y cómo relajarla
Por defecto, todo comando de shell requiere tu visto bueno. Vibe muestra exactamente lo que planea ejecutar y luego espera:
El agente quiere ejecutar:
npm run test
¿Aprobar? (y/n)
Este mecanismo es la red de seguridad principal de la herramienta. Una propuesta accidental de rm -rf no tiene efecto hasta que la apruebas: esa es la diferencia entre un incidente y una línea de texto que rechazas con una n.
Puedes configurar este comportamiento en config.toml con permisos granulares por herramienta:
[tools.bash]
permission = "ask" # Preguntar siempre (predeterminado)
# O para un agente de confianza:
# permission = "always" # Ejecutar sin preguntar
También puedes relajar esto sobre la marcha: Mayús+Tab alterna el modo de aprobación automática, donde Vibe ejecuta comandos sin confirmación. Esto resulta cómodo durante sesiones de desarrollo intensivo en las que sigues al agente paso a paso, pero manéjalo con cuidado, ya que estás omitiendo la red de seguridad descrita anteriormente. El sistema Trust Folder (Carpeta de confianza) ayuda a limitar el riesgo: solo los directorios marcados explícitamente como seguros en ~/.vibe/trusted_folders.toml permiten la aprobación automática. Un repositorio clonado para solucionar problemas y nunca declarado no se beneficiará de esto.
Encadenamiento, referencias y borradores
El prefijo @ también funciona para comandos: hacer referencia a un archivo inyecta su contenido en el contexto, lo que permite al agente comprender antes de actuar.
Ejecuta el script @scripts/deploy.sh y explica qué hace
El agente lee el script primero, lo analiza y luego lo ejecuta si lo apruebas: un orden particularmente tranquilizador para un script de despliegue que no has escrito tú.
Para una secuencia de operaciones, compone un mensaje multilínea usando Ctrl+J o Mayús+Intro:
Ejecuta estos comandos en orden:
1. git stash
2. git pull origin main
3. git stash pop
4. npm install
5. npm run build
Vibe ejecuta los pasos secuencialmente, se detiene si uno falla y te muestra el resultado de cada uno. Esto evita que descubras un fallo en stash pop solo después de una compilación inútil. Y si el mensaje que necesitas redactar se vuelve largo o estructurado, Ctrl+G abre tu editor externo definido por $EDITOR: escribes cómodamente, guardas, cierras y el contenido pasa a Vibe.
Qué habilitan estos comandos en el trabajo diario
La gestión de dependencias se presta bien al encadenamiento automático: «Actualiza todas las dependencias de npm y comprueba vulnerabilidades» desencadena npm update y luego npm audit, ofreciéndote un resumen en lugar de un muro de salida. Sin embargo, el impacto es más claro con las pruebas. Una solicitud como «Ejecuta las pruebas y, si alguna falla, analiza los errores y propone correcciones» agrupa ejecución, diagnóstico y una propuesta de arreglo en un único intercambio.
El mismo principio se aplica al resto de la cadena: pídele que compile el proyecto en modo producción y verifique que no haya errores de TypeScript, o que liste los contenedores Docker en ejecución y muestre los registros del contenedor api. En todos estos casos, describes el objetivo, el agente elige los comandos y tú mantienes el control en la fase de aprobación.
Puntos clave
- El prefijo
!ejecuta un comando de shell directamente desde el modo interactivo - El agente también puede determinar y ejecutar comandos apropiados usando lenguaje natural
- Por defecto, todo comando requiere aprobación (configurable en config.toml)
- El terminal tiene estado: las variables y el directorio actual se conservan
- El modo de aprobación automática (Mayús+Tab) elimina las confirmaciones: úsalo con precaución
- El sistema Trust Folder asegura la aprobación automática por directorio