Scripts
Un script es un script de shell o de PowerShell que VMPal guarda en su Hub. Se ejecuta en tu Mac, en una máquina virtual o en un clon nuevo de una máquina virtual, como un runner de CI limpio, pero con tu propia configuración y tus propios datos. Ejecútalo desde el Hub, o haz que lo ejecute tu agente de IA o vmpal.
Pregúntale a tu agente de IA
La forma más sencilla de escribir y ejecutar un script es pedírselo a tu agente de programación. Escribe el script y lo guarda en el Hub de VMPal. Lo ejecuta donde le digas y lee el registro cuando falla una ejecución. Para ello usa las herramientas MCP de VMPal, o vmpal script en su terminal.
- En VMPal, abre Ajustes › Agentes de IA y activa Permitir que los agentes de programación de este Mac gestionen todas las máquinas virtuales.
- Haz clic en Añadir a Claude Code o en el botón de otro agente (cuáles), y reinicia el agente.
- Pídele, por ejemplo:
- “Escribe un script de VMPal que compile esta app en mi máquina virtual de Windows y ejecútalo ahora.”
- “Ejecuta mi script de pruebas y dime por qué ha fallado.”
- “Haz que mi script de compilación se ejecute en un clon nuevo de mi máquina virtual de Ubuntu y que se detenga a los 30 minutos.”
El resto de esta página explica cómo funcionan los scripts, por si quieres saberlo.
Crea uno
VMPal guarda tus scripts en su Hub.
- Abre el Hub. Haz clic en Hub en la barra de herramientas de la ventana de VMPal, o elige Visualización › Hub (⌘2).
- Haz clic en Nuevo script. Ponle nombre, elige su lenguaje, escríbelo y haz clic en Crear. Un script nuevo empieza con un comentario que enumera sus variables.
- Elige dónde se ejecuta. Haz clic en Seleccionar… junto a Se ejecuta en, en la barra lateral. O abre el menú del script (haz clic con el botón derecho en el script o haz clic en ⋯) y elige Cambiar dónde se ejecuta….
En la lista del Hub, haz doble clic en un script o pulsa Retorno para editarlo, pulsa Eliminar para eliminarlo, y arrástralo hacia arriba o hacia abajo para reordenar la lista. En la lista de máquinas virtuales de VMPal, una máquina virtual en la que se ejecutan scripts muestra una marca de script. Haz clic en ella para verlos en el Hub.
Dónde se ejecuta
Un script puede ejecutarse en un clon nuevo de una máquina virtual, en la propia máquina virtual o en tu Mac. Si eliges más de un lugar, se ejecuta en cada uno.
Las ejecuciones en una máquina virtual necesitan el control por agentes, así que VMPal lo activa en cada máquina virtual en la que se ejecuta un script.
Un clon nuevo de una máquina virtual
Es la opción predeterminada para una máquina virtual. Un clon es una copia desechable de la máquina virtual, como un runner de CI recién creado. Cada ejecución recibe su propio clon, y VMPal lo elimina después de la ejecución.
- Es ligero. VMPal crea el clon al instante. Los clones ligeros necesitan APFS. Para una máquina virtual en una unidad que no es APFS, las ejecuciones usan la propia máquina virtual.
- La máquina virtual debe estar apagada. Usa Apagar en la máquina virtual. Cerrar su ventana guarda la máquina virtual en lugar de apagarla.
- Una ejecución espera hasta 30 minutos a que la máquina virtual se apague. Pasado ese tiempo, VMPal omite la ejecución.
- El clon no tiene nada de tu Mac. No recibe carpetas compartidas, puertos reenviados ni portapapeles.
La propia máquina virtual
Para ejecutarlo en la propia máquina virtual, desmarca Clonar una nueva máquina virtual en cada ejecución debajo de la máquina virtual cuando elijas dónde se ejecuta el script. Entonces, la barra lateral muestra Se ejecuta en la propia máquina virtual debajo de la máquina virtual.
- VMPal inicia o reanuda la máquina virtual en segundo plano. Inicia sesión en la pantalla de inicio de sesión con la contraseña que guarda VMPal. Deja la máquina virtual en marcha después de la ejecución.
- Si la máquina virtual está en pausa, la ejecución espera hasta que se reanude.
- La ejecución usa las carpetas compartidas, el portapapeles y la red de la propia máquina virtual, tal como los configuraste.
Este Mac
El script se ejecuta en tu Mac, como tú. Scripts en este Mac decide si vmpal y los agentes de IA pueden hacer que un script se ejecute aquí.
Cómo se ejecuta
Cada script se ejecuta con el shell del lugar donde se ejecuta:
| Dónde | Lenguaje | Se ejecuta con |
|---|---|---|
| Máquina virtual de Linux | Shell | bash |
| Máquina virtual de macOS | Shell | zsh |
| Tu Mac | Shell | zsh, o el intérprete de su línea #! |
| Máquina virtual de Windows | PowerShell | Windows PowerShell |
- Un script de shell se ejecuta como shell de inicio de sesión, desde la carpeta de inicio.
- Las ejecuciones usan la cuenta del usuario, no root. Leen los archivos del shell de inicio de sesión:
~/.profileen Linux (no~/.bashrc), y~/.zprofileen macOS y en tu Mac (no~/.zshrc). Así que instala tus herramientas para todos los usuarios, o define elPATHen esos archivos. - El código de salida decide si una ejecución es correcta. El código 0 significa que es correcta. Cualquier otro significa que ha fallado.
- PowerShell sigue adelante cuando falla un programa. Así que comprueba
$LASTEXITCODEdespués de cada uno. - VMPal no copia nada de tu Mac salvo el script. Tu script obtiene tu código por su cuenta, por ejemplo con
git clone.
Ejecútalo
Haz clic en Ejecutar ahora en la barra lateral o en el menú del script. El script se ejecuta en cada lugar que elegiste. Si todavía no has elegido ninguno, VMPal te pregunta dónde.
Para ejecutarlo en otro lugar, mantén pulsada la tecla Opción en el menú del script y elige Ejecutar en…. VMPal te pregunta primero dónde. Ejecuta el script allí y, a partir de entonces, lo sigue ejecutando allí.
Historial
Historial, en la barra lateral, enumera cada ejecución. Muestra el estado de la ejecución, cuánto duró y por qué falló o está esperando.
- Mostrar registro abre la salida de una ejecución.
- Detener detiene una ejecución. Detener ejecuciones, en el menú del script, las detiene todas.
- Haz doble clic en un elemento para verlo entero, con el registro de cada ejecución a medida que llega.
Registros
Los registros están en tu Mac, en ~/Library/Logs/VMPal/Hub. En el Hub, Ayuda › Mostrar registros en el Finder abre los registros del script.
- VMPal limita cada registro a 16 MiB. Un registro más largo conserva su principio y su final.
- VMPal conserva las 50 últimas ejecuciones terminadas de cada script, con sus registros.
Salir de VMPal
Si hay ejecuciones en curso cuando sales de VMPal, primero te pregunta, con Detener ejecuciones y salir. Después detiene las ejecuciones y elimina sus clones. Las ejecuciones que siguen en espera cuando VMPal se cierra nunca se inician. Y no se inicia nada mientras haya una actualización pendiente de instalar.
Sus ajustes
Para cambiar los ajustes de un script, elige Editar script… en su menú, o haz clic en Editar… junto a su nombre en la barra lateral.
| Ajuste | Qué hace |
|---|---|
| Lenguaje | Shell, o PowerShell para máquinas virtuales de Windows |
| Tiempo límite | VMPal detiene una ejecución que dura más. Elige entre 5 minutos y 6 horas. De forma predeterminada es 1 hora. Con vmpal, puedes definir hasta 24 horas |
| Color | Tiñe la fila del script en el Hub y la marca de script de las máquinas virtuales en las que se ejecuta. Elige uno de los colores del Mac, o ninguno. Color en el menú del script, y el botón de color junto a su nombre en la barra lateral, también lo cambian |
En el menú del script, Duplicar coloca una copia del script justo detrás de él. Eliminar script… elimina el script, sus ejecuciones y sus registros.
Las variables
Cada ejecución recibe estas variables de entorno:
| Variable | Valor |
|---|---|
VMPAL_SCRIPT_NAME |
El nombre del script |
VMPAL_RUN_ID |
El ID de la ejecución |
VMPAL_TARGET |
Dónde se ejecuta: mac, o el nombre de la máquina virtual |
En PowerShell, son $env:VMPAL_SCRIPT_NAME, etc.
Límites
- Una ejecución a la vez en cada lugar. En cada lugar donde se ejecuta, un script solo tiene una ejecución en curso y, como mucho, otra en espera. Una ejecución más reciente ocupa el lugar de la que estaba en espera.
- Dos clones a la vez. Como máximo, hay dos ejecuciones en clones al mismo tiempo. El siguiente clon de una máquina virtual de un script espera hasta que VMPal elimina el anterior.
- Dos máquinas virtuales de macOS a la vez. macOS permite como máximo dos máquinas virtuales de macOS a la vez, incluidas las que ejecutas tú. Cuando hay dos en marcha, una ejecución en una máquina virtual de macOS espera a que se detenga una.
- La propia máquina virtual admite una ejecución a la vez, sea cual sea su script. Un script que se ejecuta en la propia máquina virtual puede tener como máximo 32.000 bytes (en UTF-8). VMPal omite las ejecuciones de un script más largo, así que ejecútalo en un clon.
- 30 minutos para empezar. VMPal omite una ejecución que lleva 30 minutos esperando para empezar, por ejemplo, a que su máquina virtual se apague.
Scripts en este Mac
Un script en tu Mac ejecuta código como tú. Por eso, VMPal comprueba un ajuste cuando vmpal o un agente de IA harían que un script se ejecutara en tu Mac, es decir, cuando pretenden:
- añadir tu Mac a los lugares donde se ejecuta un script
- ejecutar allí un script ahora
- cambiar el texto de un script que se ejecuta allí
El ajuste es Ajustes › Agentes de IA › Scripts en este Mac:
| Opción | Qué hace VMPal |
|---|---|
| Permitir (los agentes te preguntan) | La opción predeterminada. VMPal lo permite sin preguntarte. A los agentes se les indica que te pregunten primero, pero VMPal no puede comprobarlo. Así que cualquier app de tu Mac podría ejecutar código como tú de esta forma |
| Preguntar en VMPal | VMPal te muestra el texto del script y dónde se ejecuta, y te pregunta. Pregunta una vez por cada versión del script |
| Desactivado | VMPal lo rechaza |
El ajuste no cambia los scripts en máquinas virtuales ni lo que haces en el Hub.
Con vmpal
vmpal es la herramienta de línea de comandos de VMPal, como docker o gh. Sus comandos vmpal script hacen lo mismo que el Hub:
| Comando | Qué hace |
|---|---|
vmpal script create <name> --file <path> |
Guarda un script. Elige dónde se ejecuta con --run-in <VM> para un clon nuevo de la máquina virtual, --run-in-place <VM> para la propia máquina virtual y --host para este Mac |
vmpal script run <script> --wait |
Lo ejecuta ahora y espera a sus ejecuciones. Su código de salida indica si fueron correctas |
vmpal script log <script> |
Muestra la salida de la ejecución más reciente |
vmpal script runs <script> |
Enumera sus ejecuciones, con sus estados y por qué fallaron |
vmpal script edit <script> |
Cambia su texto, sus ajustes o dónde se ejecuta |
vmpal script create "Build" --file build.sh --timeout 30m --run-in "Ubuntu"
vmpal script run "Build" --wait
vmpal script log "Build"
Comandos enumera el resto. Los agentes de IA hacen lo mismo con las herramientas MCP de VMPal, como vmpal_create_script, vmpal_run_script y vmpal_get_run_log. Necesitan que esté activado Permitir que los agentes de programación de este Mac gestionen todas las máquinas virtuales.